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MANUAL  OBJECTIVES 

The  RSX-1 1 M/M- PLUS  System  Management  Guide  documents  system  programs 
and  procedures  that  test,  monitor,  maintain,  and  customize 
RSX-1 1M/M-PLUS  operating  systems  after  system  generation. 


INTENDED  AUDIENCE 

This  manual  is  intended  for  system  managers,  operators,  and  system 
programmers  who  perform  system  management  functions.  The  manual  is 
not  intended  for  general  users  or  applications  programmers. 


STRUCTURE  OF  THE  MANUAL 


The  RSX-1 1M/M- PLUS  System  Management  Guide  consists  of  18  chapters  and 
two  appendixes  as  follows: 

Chapter  1  summarizes  each  program  and  procedure  described  in  Chapters 
2  through  18. 

Chapter  2  describes  how  you  use  the  Account  File  Maintenance  Program 
( ACNT)  to  create  and  maintain  accounts  on  multiuser  protection 
systems. 

Chapter  3  describes  how  you  use  the  Console  Logger  to  handle  I/O  to 
the  console  output  device  (CO) :  and  record  system  messages  at  a 
terminal  and/or  in  a  log  file. 

Chapter  4  describes  how  you  use  the  I/O  Exerciser  (IOX)  to  detect  and 
diagnose  I/O  problems  on  the  disk  and  tape  units  in  your  system's 
hardware  configuration. 


Chapter  5  describes  how  the  Bad  Block  Replacement  Control  Task  (RCT) 
performs  bad  block  handling  and  recovery  on  Mass  Storage  Control 
Protocol  (MSCP)  devices  such  as  the  RA80. 

Chapter  6  describes  how  you  use  the  Resource  Monitoring  Display  (RMD) 
to  display  information  about  the  active  tasks  in  your  operating  system 
and  the  availability  of  system  resources. 


Chapter  7  describes  how  to  set  up  the  Queue  Manager 
convenience  of  multistream  line-printer  spooling. 


for  the 


For  RSX-1 1M-PLUS  systems  only,  this  chapter  describes  how  you  set  up 
batch  processors  that  enable  you  to  direct  a  command  sequence  to  the 
operating  system  at  a  predetermined  time  of  day. 
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Chapter  8  describes  how  you  use  the  SHUTUP  Program  to  shut  down  the 
system  in  an  orderly  fashion. 

Chapter  9  describes  how  you  use  the  User  Environment  Test  Package 
(UETP)  after  system  generation  to  verify  that  you  have  generated  a 
working  operating  system. 

Chapter  10  describes  how  you  use  the  Virtual  Monitor  Console  Routine 
(VMR)  to  alter  a  system  image  file  on  disk. 

Chapter  11  describes  command  line  interpreter  tasks,  how  to  write 
them,  and  the  use  of  new  Executive  directives  in  them. 

Chapter  12  describes  how  to  task  build  and  install  the  DCL  task  with 
various  options.  It  also  describes  the  Macro  Meta  language,  which  is 
a  set  of  macros  that  describes  the  mapping  from  DCL  syntax  to  MCR 
syntax.  With  this  language,  you  can  alter  or  add  commands  to  extend 
DCL. 

Chapter  13  describes  the  Pool  Monitoring  Support  that  controls  the  use 
of  the  system's  dynamic  storage  region  (pool). 

Chapter  14  describes  the  Shuffler,  which  is  a  task  that  compacts 
memory  space  in  system-controlled  partitions. 

Chapter  15  describes  how  you  use  the  RSX-11M-PLUS  reconfiguration 
services  (CON  and  HRC)  to  reconfigure  system  resources  to  isolate  the 
system  from  the  effects  of  faulty  hardware  elements. 

Chapter  16  describes  RSX-11M-PLUS  I/O  Queue  Optimization,  which 
improves  the  throughput  of  the  disk  subsystems  used  in  your  system. 

Chapter  17  describes  RSX-11M-PLUS  Resource  Accounting,  which  creates  a 
transaction  file  of  system  usage  information. 

Chapter  18  describes  RSX-11M-PLUS  Shadow  Recording,  which  allows  your 
system  to  back  up  all  information  being  written  to  a  Files-11  disk. 

Appendix  A  describes  the  Serial  Despooler,  which  is  superseded  by  the 
Queue  Manager  to  handle  line-printer  spooling  for  most  systems. 

Appendix  B  describes  the  set  of  User  File  Directory  (UFD)  conventions 
observed  by  the  operating  system  for  files  on  disk.  A  section  of 
file-naming  conventions  is  also  included. 


ASSOCIATED  MANUALS 

Before  you  read  this  manual,  you  should  be  familiar  with  the 
RSX-1 1 M/M- PLUS  MCR  Operations  Manual ,  the  RSX-1 1M/M-PLUS  Utilities 
Manual ,  and,  for  DIGITAL  Command  Language  users,  the  RSX-1 1M/M-PLUS 
Command  Language  Manual.  Although  you  do  not  need  to  read  the  RSX-11M 
System  Generation  and  Installation  Guide  or  the  RSX-11M-PLUS  System 
Generation  and  Installation  Guide  before  reading  this  manual,  system 
generation  logically  precedes  your  use  of  the  programs  and  procedures 
documented  in  this  manual. 
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CONVENTIONS  USED  IN  THIS  MANUAL 


Convention 

Meaning 

red  ink 

Designates  user  input.  Responses  from 

programs  are  designated  in  black  ink. 

blue  ink 

Designates  RSX-11M-PLUS  multiprocessor  system 
information. 

•  •  • 

A  horizontal  ellipsis  indicates  that  the 
command  line  element  immediately  preceding 
the  ellipsis  can  be  repeated  one  or  more 
times . 

• 

• 

• 

A  vertical  ellipsis  indicates  that  part  of  a 
command  sequence  or  program  output  continues 
but  is  not  relevant  to  the  discussion  of  the 
example . 

lowercase 

In  a  command  line,  lowercase  words  and 
letters  indicate  that  you  substitute  a  value. 
Usually  the  lowercase  word  describes  the 
value  to  be  substituted. 

UPPERCASE 

Command  elements  other  than  those  shown  in 
lowercase  for  which  you  substitute  a  value 
are  always  uppercase.  Within  descr ipt ions , 
these  command  elements  are  never  truncated. 
In  examples,  they  may  be  truncated  according 
to  the  rules  of  the  particular  program. 

o 

A  reverse  number  is  a  white  number  printed  in 
a  black  circle.  These  numbers  key  a  part  of 
an  example  to  the  text  that  explains  that 
part  of  the  example.  The  reverse  number 
appears  both  in  the  example  and  the 
explanation. 

[optional] 

Square  brackets  indicate  that  the  enclosed 
item  is  optional. 

shading 

Shaded  portions  of  text  describe  only  one 
operating  system. 

. 

Gray  shading  indicates  that  the  text 
describes  only  RSX-11M-PLUS  operating 
systems.  Shading  is  not  used  in  Chapters 
that  describe  programs  that  are  unique  to 
RSX-11M-PLUS. 

Red  shading  indicates  that  the  text  describes 
only  RSX-11M  operating  systems. 

Portions  of  text  that  are  not  shaded  describe 
both  operating  systems,  except  in  the 
RSX-llM-PLUS-only  chapters. 

(CTRL/X) 

The  symbol  CTRL/x  indicates  that  you  press  a 
key  while  simultaneously  pressing  and  holding 
down  the  CTRL  key;  for  example,  CTRL/C, 
CTRL/O. 
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SUMMARY  OF  TECHNICAL  CHANGES 


The  RSX-1 1 M/M- PLUS  System  Management  Guide  documents  these  new 
capabilities  of  RSX-11M  V4.0  and  RSX-11M-PLUS  V2.0: 

1.  The  Bad  Block  Replacement  Control  Task  (RCT)  performs  bad 
block  handling  and  recovery  on  Mass  Storage  Control  Protocol 
(MSCP)  devices  such  as  the  RA80. 

2.  DIGITAL  Command  Language  is  available  on  RSX-11M  V4.0. 

3.  You  can  augment  the  DIGITAL  Command  Language  with  your  own 
commands  and  write  your  own  command  language  interpreters. 

The  other  programs  and  procedures  described  in  this  manual  have  all 
been  enhanced  to  include  new  functionality.  The  following  lists 
descriptions  of  new  software  and  the  enhancements  to  previously 
existing  software  for  RSX-11M  V4.0  and  RSX-11M-PLUS  V2.0. 


C 

c 


Account  File  Maintenance  Program  ( ACNT) 


1.  When  adding  or  modifying  an  account  entry,  you  can  specify  a 
default  command  language  interpreter  (CLI) . 

2.  When  adding  or  modifying  an  account  entry,  you  can  specify 
whether  or  not  the  terminal  on  which  a  user  logs  in  is  to  be 
a  slaved  terminal. 

3.  You  can  specify  logical  device  names  as  the  user's  default 
device  (SY: ) . 


Console  Logger 

1.  You  interface  with  the  Console  Logger  with  one  keyword  from 
MCR  or  DCL  instead  of  five. 


2.  Tasks  can  read  from  the  console  terminal. 


3.  The  Console  Logger  time-stamps  messages  written  to  the 
console  output  device  (CO:). 


I/O  Exerciser  (IOX) 

1.  Three  new  commands: 

a.  COMPAREDATA  allows  you  to  disable  data  compar 
testing . 


isons  dur 


ing 
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b.  RANGE  allows  you  to  determine  the  range  of  blocks  to  be 
tested  on  nonfile-structured  disks.  You  can  also  use 
RANGE  to  display  the  current  range  of  blocks  to  be  tested 
on  the  specified  disk. 

c.  RECORDS  allows  you  to  specify  the  number  of  records  to 
test  on  magnetic  tapes  and  cassettes. 

2.  The  ITERATIONS  command  has  been  eliminated. 

3.  The  FILES1 1 ,  SELECT,  and  VERIFY  commands  have  been  modified 
to  accept  commands  in  their  command  lines  that  set  exercise 
parameters . 

4.  Exercising  of  magnetic  tapes  and  DECtapes  has  been  improved 
to  allow  testing  of  the  entire  tape  and  the  testing  of  one 
tape  while  another  is  rewinding. 

5.  The  CONFIGURE  command  allows  you  to  specify  multiple  units 
per  command  line.  CONFIGURE  also  accepts  any  disk  or  tape 
unit  to  which  you  can  assign  a  logical  name  with  the  MCR  ASN 
command . 

6.  The  EXECUTE  command  sends  leading  blanks  to  the  task  to  be 
executed . 

7.  You  can  use  CTRL/O  with  the  PARAMETERLIST  and  PRINTSUMMARY 
commands  while  no  exercising  is  in  progress. 

8.  The  random  data  pattern  from  pure  portions  of  the  IOX  task  is 
the  default  pattern. 

Resource  Monitoring  Display  (RMD) 

1.  Two  new  displays  have  been  added:  Active  Task  Display  and 
Task  Header  Display. 

2.  RMD  parses  an  MCR  command  line  so  that  you  can  select  a 
display  page  and  enter  setup  commands  from  the  MCR  command 
line. 

3.  The  Memory  Display  includes  a  DECnet  node  name  or  system 
name . 


Setting  Up  and  Running  the  Queue  Manager 

1.  MCR  and  DCL  are  supported. 

2.  Naming  conventions  for  the  spooled  output  device,  the 
device-specific  queues  (colon  optional),  the  device  itself, 
and  the  processor  that  "owns”  the  device  (colon  optional) 
have  been  changed  so  that  these  entities  all  have  the  same 
name;  for  example,  LPO:. 

3.  You  can  now  initialize  print  processors  as  shareable.  This 
means  that  a  line  printer  is  not  permanently  attached.  It  is 
attached  only  while  the  Queue  Manager  is  passing  a  print  job 
to  i  t . 

4.  For  RSX-11M  systems,  you  now  have  to  explicitly  create  the 
device-specific  queues . 
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SHUTUP  Program 

1.  Messages  include  a  DECnet  node  name  or  system  name. 

2.  The  NOBROADCAST  bit  is  honored  except  during  the  last  five 
minutes  before;  shutdown. 

3.  The  message  "SHUTUP  operation  complete"  is  output  before  the 
system  halts. 

4.  A  task-build  option  lets  you  specify  the  time-out  interval 
for  [1, 2] SHUTUP.CMD. 

User  Environment  Test  Package  (UETP) 

1.  You  can  specify  devices  to  be  excluded  from  testing. 

2.  You  can  determine  how  many  times  to  run  UETP. 

3.  You  can  select  one  or  more  of  the  five  UETP  tests. 

4.  UETP  prints  a  message  identifying  the  test  and  the  time  at 
the  start  and  end  of  each  test. 

5.  UETP  searches  for  RSXMC.MAC. 


Virtual  Monitor  Console  Routine  (VMR) 

VMR  can  now  fix  and  unfix  tasks  in  system-controlled  partitions  on 
mapped  systems.  Both  the  mapped  and  unmapped  versions  of  VMR  can  be 
used  to  fix  and  unfix  a  task. 

The  following  are  new  or  revised  commands  for  VMR: 


FIX 


INS 


New  keywords  are: 


/DIR 

(RSX-1 1M -PLUS  systems  only.) 
that  the  task  to  be  fixed  is  a 
common. 

Specifies 

directive 

/NSF 

(RSX-1 1M -PLUS  systems  only.) 

Specifies 

that  the  task  to  be  fixed 
nonshuf f leable . 

will  be 

New  keywords 

are : 

/CLI 

Specifies  that  the  task  being 

installed 

is  a  command  line  interpreter 

(CLI) . 

/FIX 


(RSX-11S  systems  only.) 
whether  memory-resident  tasks 
will  be  fixed  in  memory. 


Specifies 
on  RSX-11S 


/IOP 


Specifies  that  a  privileged 
overmap  the  I/O  page. 


task  can 


/SEC  (RSX-1 1M-PLUS  systems  only.)  Places  in 

secondary  pool  the  Task  Control  Block 
for  the  task  being  installed. 
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SAVE 


SET 


/SYNC 

(RSX-1 1M -PLUS  multiprocessor  systems 
only.)  Synchronizes  task  use  of  a  common 
region. 

/XHR 

(RSX-1 1M -PLUS  systems  only.)  Specifies 
that  the  Executive’s  copy  of  a  task's 
header  will  be  kept  in  an  area  external 
to  the  system's  dynamic  storage  area 
(pool)  . 

New  keywords  are: 

/BOOT 

Allows  a  system  saved  on  an  RX02  to  be 
booted  on  RX01  and  vice  versa. 

/DENS 

Specifies  1600  bpi  density  for  the 

following  magnetic  tapes:  TE1 6 ,  TU16, 
TU45,  and  TU77. 

New  or  revised 

keywords  are: 

/ABAUD 

Enables  autobaud  detection  for  a 

terminal's  remote  dial-up  line. 

/BRO 

Specifies  whether  a  terminal  will 
receive  messages  from  the  MCR  BROADCAST 
command . 

/MAXEXT 

Establishes  the  maximum  size  to  which  a 
task  can  extend  itself  by  means  of  the 
Executive  EXTEND  TASK  directive. 

/NETUIC 

Specifies  the  UIC  in  which 

DECnet-related  tasks  will  be  stored. 

/OPT 

(RSX-1 1M-PLUS  systems  only.)  Enables 
disk  I/O  queue  optimization  for  a 
device. 

/PLCTL 

Displays  or  sets  the  pool  limit 
parameters  used  by  the  Pool  Monitor  Task 
( PMT) . 

/PUB 

Displays  or  sets  a  device  public  (/PUB) 
or  nonpublic  (/NOPUB) . 

/REMOTE 

Now  allows  the  setting  of  the  initial 
baud  rate  of  a  remote  dial-up  line  for  a 
terminal . 

/RNDC 

(RSX-1 1M -PLUS  systems  only.)  Defines  the 
length  of  the  Executive  round-robin 
schedul ing  interval. 

/RNDH 

(RSX-1 1M -PLUS  systems  only.)  Defines  the 
highest  priority  that  will  be  considered 
for  Executive  round-robin  scheduling. 

/RNDL 

(RSX-1 1M -PLUS  systems  only.)  Defines  the 
lowest  priority  that  will  be  considered 
for  Executive  round-robin  scheduling. 

/SECPOL 

(RSX-1 1M -PLUS  systems  only.)  Displays 
secondary  pool  use  in  the  system. 
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/SWPC 

(RSX-1 1M -PLUS 

systems 

only • ) 

Defines  the 

length  of  a 
interval . 

single 

Executive  swapping 

/SWPR 

(RSX-1 1M -PLUS 

systems 

only . ) 

Defines  a 

new  priority  range 

swapping . 

>  for 

HHHH 

Executive 

/TERM  New  terminal  types  allowed:  LA12,  LA34, 

LA38 ,  LAI 00 ,  VT101,  VT102,  VT105,  VT125, 
VT 131,  and  VT132. 


I/O  Queue  Optimization 

A  new  chapter  describes  how  RSX-11M-PLUS  users  can  improve  throughput 
of  disk  subsystems. 

Resource  Accounting 

The  RSX-1 1M-PLUS  Resource  Accounting  description  contains  the 
following  new  information 

1.  You  can  specify  that  task  accounting  be  performed. 

2.  You  can  convert  a  transaction  file  to  one  that  is  readable  by 
DATATR I EVE - 1 1 .  This  allows  you  to  write  a  resource  accounting 
report  program  in  DA TATRI EVE-11. 

3.  You  can  collect  device  statistics  for  disk  subsystems. 


xxi 


CHAPTER  1 


INTRODUCTION 


This  chapter  summarizes  the  functions  of  the  programs  and  procedures 
documented  in  the  chapters  of  this  manual.  Each  chapter  is  summarized 
in  the  order  in  which  it  is  presented  in  the  manual. 


Chapter  2  -  Account  File  Maintenance  Program  (ACNT) 

The  Account  File  Maintenance  Program  (ACNT)  allows  a  privileged  user 
to  create  and  maintain  an  account  file  on  multiuser  protection 
systems.  Each  account  entry  consists  of  such  information  as  an 
account  number  (the  user's  UIC)  and  password,  default  device  (SY:), 
user's  first  and  last  name,  and  default  command  language  interpreter 
(CLI) .  ACNT  allows  a  privileged  user  to  create  an  account  file,  add 
and  delete  accounts,  modify  accounts,  list  the  accounts,  examine  an 
individual  account,  and  sort  the  account  entries. 

The  chapter  gives  an  example  of  how  to  use  each  ACNT  function. 


Chapter  3  -  Console  Logger 

The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT...) 
that  handle  I/O  to  the  console  output  device  (CO:)  and  record 
time-stamped  system  messages  on  a  terminal  and/or  in  a  log  file.  You 
use  MCR  SET  commands  from  a  privileged  terminal  to  start  and  stop 
console  logging,  disable  the  log  file  or  the  console  terminal,  and 
reassign  the  log  file  and  console  terminal.  You  select  Console  Logger 
support  during  SYSGEN. 

The  chapter  documents  the  console  logging  commands  and  presents  an 
extensive  terminal  session  with  explanations  of  the  commands  used  in 
the  session. 


Chapter  4  -  I/O  Exerciser  (IOX) 

The  I/O  Exerciser  (IOX)  detects  and  diagnoses  I/O  problems  on  the  disk 
and  tape  units  in  your  system's  hardware  configuration.  IOX  exercises 
Files-11  disks,  non-file-structured  disks,  magnetic  tapes,  DECtapes, 
and  cassettes.  IOX  performs  three  kinds  of  exercises.  The  IOX 
Command  Language  enables  you  to  specify  and  control  the  exercise  for 
the  units  in  your  system.  You  choose  an  exercise  appropriate  to  a 
unit  and  set  exercise  parameters  that  determine  how  the  unit  is 
exercised. 
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The  chapter  documents  each  IOX  command  in  alphabetical  order  and  gives 
examples  that  illustrate  and  explain  how  to  set  parameters  for  the 
three  kinds  of  IOX  exercises. 


Chapter  5  -  Bad  Block  Replacement  Control  Task  (RCT) 

The  Bad  Block  Replacement  Control  Task  (RCT)  handles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Protocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages:  detecting,  notifying,  replacing,  and  revectoring.  The  disk 
controller  (UDA50 )  detects  bad  blocks  and  notifies  the  driver  (DUDRV) • 
The  driver  activates  RCT.  RCT  performs  the  bad  block  replacement 
functions  that  enable  the  controller  to  revector  (redirect)  I/O  from 
the  bad  block  to  the  replacement  block. 

RCT  also  performs  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  during  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  were  copied  to  the  disk. 


Chapter  6  -  Resource  Monitoring  Display  (RMD) 

The  Resource  Monitoring  Display  (RMD)  provides  information  about  the 
active  tasks  in  your  operating  system  and  the  availability  of  system 
resources.  This  information  includes  the  active  tasks,  their  location 
in  memory,  the  amount  of  memory  they  occupy,  and  the  available  pool 
space.  RMD  generates  dynamic  displays  on  CRTs  and  "snapshot"  displays 
on  hardcopy  terminals. 

There  are  three  displays:  memory,  active  task,  and  task  header. 

There  is  also  a  help  page  that  tells  you  how  to  switch  display  pages. 
Each  display  page  has  a  setup  page  from  which  you  can  alter  the 
contents  of  the  associated  display  page.  You  can  access  any  RMD 
display  and  alter  the  contents  of  the  display  from  the  MCR  command 
line . 

On  RSX-1 1M-PLUS  systems,  a  system  statistics  display  and  error  log 
count  display  are  also  available. 

The  chapter  contains  an  example  and  explanation  of  the  memory  display. 


Chapter  7  -  Setting  Up  and  Running  the  Queue  Manager  (QMG) 

The  Queue  Manager  (QMG)  has  the  primary  function  of  controlling  the 
system's  line  printers  and  the  print  jobs  to  be  passed  to  them.  Users 
can  specify  the  number  of  copies  they  want  printed,  the  time  the  job 
is  to  be  released  for  printing,  whether  the  file  is  to  be  deleted 
after  printing,  and  which  printer  they  want  to  use.  Users  can  display 
all  information  about  the  QMG  queues  and  can  alter  the  characteristics 
of  jobs  in  queues.  Some  installations  may  have  user-written  output 
processors  that  pass  jobs  to  devices  other  than  line  printers.  The 
nonpr ivileged  functions  of  QMG  are  documented  in  the  RSX-1 1M/M-PLUS 
Batch  and  Queue  Operations  Manual . 

This  chapter  documents  the  privileged  system  management  functions  of 
QMG.  Systems  can  have  as  many  as  16  output  queues  (including  the 
default  PRINT  queue)  and  16  output  processors.  Print  processors  can 
be  initialized  to  print  a  specified  number  of  flag  pages  before  each 
print  job,  to  accept  or  reject  print  jobs  specifying  that  lowercase 
printing  is  required,  and  to  handle  many  kinds  of  printed  forms. 
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On  RSX-1 1M-PLUS  systems,  QMG  also  supports  batch  ] 

processing. 

RSX-1 1M-PLUS  systems  can  have  as  many  as  16  batch  queues  and  16  batch 

processors. 

The  chapter  includes  an  illustrated  explanation  for  setti 
Queue  Manager. 

ng  up  the 

Chapter  8  -  The  SHUTUP  Program 

The  SHUTUP  program  allows  a  privileged  user  to  shut  down  the  system  in 
an  orderly  fashion.  SHUTUP  prompts  for  the  number  of  minutes  to  wait 
before  shutdown,  the  number  of  minutes  between  shutdown  messages,  and 
the  number  of  minutes  to  wait  before  disabling  logins.  Before  halting 
the  system,  SHUTUP  performs  cleanup  functions  such  as  logging  off  all 
logged-in  terminals,  submitting  the  user-written  command  file 
LB: [ 1 , 2] SHUTUP. CMD  to  Indirect  for  execution,  stopping  the  Queue 
Manager,  Console  Logger,  and  Error  Logger  (if  present),  deallocating 
checkpoint  space,  and  dismounting  mounted  devices. 

The  chapter  provides  an  example  and  explanation  of  SHUTUP  output. 


Chapter  9  -  User  Environment  Test  Package  (UETP) 

The  User  Environment  Test  Package  (UETP)  is  used  after  system 
generation  to  verify  that  you  have  generated  a  working  operating 
system.  UETP  consists  of  several  command  files  that  verify  the 
presence  and  operation  of  devices,  test  the  basic  Executive  features, 
and  verify  the  presence  of  system  utilities. 

UETP  consists  of  five  test  modules:  Load  Test,  I/O  Exerciser  Test, 
Utilities  Test,  MCR  Command  Test,  and  Interactive  Utilities  Test.  You 
can  select  which  of  these  tests  to  run,  indicate  how  many  times  to  run 
UETP,  select  or  omit  extended  comments,  and  exclude  devices  from 
testing . 

The  chapter  contains  a  sample  UETP  terminal  session. 


Chapter  10  -  Virtual  Monitor  Console  Routine  (VMR) 

The  Virtual  Monitor  Console  Routine  (VMR)  is  a  task  that  contains  a 
subset  of  the  Monitor  Console  Routine  (MCR)  commands.  You  use  VMR  to 
make  the  same  changes  to  the  system  image  file  on  disk  that  you  would 
make  to  the  running  system  with  MCR.  Some  of  these  changes  are 
setting  the  size  of  pool,  creating  partitions,  loading  drivers,  and 
installing  tasks.  The  advantage  of  using  VMR  is  that  you  can  almost 
completely  configure  a  system  image  file  before  you  boot  it. 

The  chapter  presents  each  of  the  VMR  commands  in  alphabetical  order. 


Chapter  11  -  Command  Language  Interpreters 

A  command  line  interpreter,  or  CLI,  is  a  task  that  services 
unsolicited  commands  meant  for  the  operating  system  or  an  application. 
These  commands  are  not  prompted  for  by  any  task  nor  are  they  given  to 
a  task  by  a  read  operation  on  a  terminal.  The  best  known  CLI  on 
RSX-1 1M/M-PLUS  is  MCR,  which  controls  the  operating  system. 
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A  CLI  is  also  an  efficient  means  of  interfacing  an  application  command 
processor  to  any  number  of  terminals,  because  no  read  QIO  or  character 
AST  processing  is  involved. 

This  chapter  introduces  the  concepts  of  CLIs  on  RSX-1 1M/M-PLUS 
systems.  The  chapter  includes  enough  information  to  allow  the 
programmer  to  write  application-specific  CLIs. 


Chapter  12  -  The  DCL  Task 

The  DIGITAL  Command  Language  (DCL)  is  a  general  purpose  command 
language  syntax  implemented  on  several  DIGITAL  operating  systems. 

This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
translates  commands.  In  addition,  this  chapter  documents  the  Macro 
Meta  Language,  a  set  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  DCL,  such  as  altering  defaults  or 
eliminating  qualifiers. 


Chapter  13  -  Pool  Monitoring  Support 

Pool  monitoring  support  controls  the  use  of  the  system's  dynamic 
storage  region  (pool) .  This  support  monitors  pool  levels,  restricts 
use  of  pool,  and  notifies  you  when  pool  is  near  depletion.  This 
support  consists  of  two  parts:  the  RSX-1 1M/M-PLUS  Executive  pool 
monitor  code  and  the  privileged  Pool  Monitor  Task  ( PMT) . 


Chapter  14  -  Shuffler  Support 

The  Shuffler  (SHF)  is  a  privileged  task  that  compacts  space  in 
system-controlled  partitions  when  a  memory  allocation  failure  occurs. 
The  Shuffler  operates  only  within  system-controlled  partitions.  This 
chapter  describes  Shuffler  structure.  Shuffler  interaction  with  the 
operating  system,  ways  to  monitor  the  Shuffler,  and  Shuffler 
algorithms  for  the  operating  system. 


Chapter  15  -  RSX-11M-PLUS  Reconfiguration  Services 

The  reconfiguration  services  consist  of  two  tasks  (CON  and  HRC)  and  a 
driver  (RD:).  With  the  services,  you  can  alter  or  display  information 
about  various  system  resources  such  as  devices  and  memory.  The  main 
purpose  of  the  reconfiguration  services  is  to  allow  you  to  isolate 
faulty  hardware  so  that  it  does  not  affect  the  system  adversely. 

The  chapter  describes  the  functions  of  CON,  HRC,  and  RD:  and 
describes  the  reconfiguration  commands  and  gives  examples  of  using 
each  one.  The  chapter  also  gives  procedures  for  recovering  from 
various  hardware  errors. 
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Chapter  16  -  RSX-11M-PLUS  I/O  QUEUE  OPTIMIZATION 

I/O  Queue  Optimization  is  used  to  improve  the  throughput  of  the  disk 
subsystems  used  in  your  RSX-11M-PLUS  system.  This  is  done  by  making 
the  most  effective  use  of  the  list  of  I/O  requests  in  the  queue  for  a 
particular  disk  device.  Three  methods  of  optimization  are  provided: 
Nearest  Cylinder,  Elevator,  and  Cylinder  Scan. 


Chapter  17  -  RSX-11M-PLUS  RESOURCE  ACCOUNTING 

Resource  Accounting  provides  a  transaction  file  of  system  usage 

information.  Information  is  gathered  on  each  user  in  a  system  and  on 
total  system  utilization.  This  information  can  be  used  to  bill 

individual  users  for  the  resources  used  and  for  measuring  overall 
system  performance*  By  analyzing  the  data  in  the  transaction  file, 
you  can  determine  such  things  as  who  used  the  system,  for  how  long, 

how  much  CPU  time  they  used,  and  a  number  of  other  statistics.  For 

system  utilization,  you  can  find  out  the  number  of  users,  number  of 
logons,  how  much  input/output  was  done,  and  other  system  usage 
information.  The  information  in  the  transaction  file  can  be  displayed 
or  you  can  write  a  program  to  access  the  file  and  analyze  the  data. 

The  chapter  contains  an  example  of  a  transaction  file  output. 


Chapter  18  -  RSX-11M-PLUS  SHADOW  RECORDING 

Shadow  Recording  allows  your  system  to  back  up  all  information  as  it 
is  being  written  to  a  Files-11  disk.  It  does  so  by  creating  two 
identical  disks  called  a  "shadowed  pair."  More  than  one  pair  of  disks 
may  be  shadowed,  but  shadowed  disk  pairs  cannot  overlap.  The  first 
disk  of  the  pair,  the  primary  disk,  is  the  original  disk  that  exists 
whether  or  not  Shadow  Recording  is  active.  You  can  make  any  disk  on 
your  system,  including  the  system  disk,  the  primary  disk  of  a  shadowed 
pair. 


Appendix  A  -  Serial  Despooler  (PRT) 

The  Serial  Despooler  Task  (PRT...)  provides  a  means  of  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting  for  the 
line  printer  to  become  available,  the  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file.  This  appendix  briefly  describes 
the  Serial  Despooler  Task  and  documents  Task  Builder  information  for 
it. 


Appendix  B  -  RSX-11M/M-PLUS  UFD  CONVENTIONS 

The  RSX-11M  and  RSX-11M-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  uniform  and  consistent  method  of  locating,  allocating,  and 
maintaining  a  file  on  disk.  This  appendix  describes  group  and  member 
numbers  and  their  use  in  identifying  the  contents  of  system  UFDs.  A 
section  on  file-naming  conventions  is  also  included. 
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THE  ACCOUNT  FILE  MAINTENANCE  PROGRAM  ( ACNT) 


RSX-1 1M/M-PLUS  provides  an  Account  File  Maintenance  Program  (ACNT)  for 
creating  and  maintaining  an  account  file  on  a  multiuser  system.  The 
account  file  contains  entries  for  all  User  Identification  Codes  (UICs) 
authorized  within  the  multiuser  protection  system.  One  UIC  can  have 
several  users,  each  user  having  his  or  her  password.  When  a  user 
tries  to  log  in,  the  system  checks  the  HELLO  or  LOGIN  command 
parameters  against  the  account  file  to  determine  whether  or  not  the 
user  should  have  access  to  the  system. 


2.1  CONTENTS  OF  THE  ACCOUNT  FILE 

Each  account  in  the  account  file  contains  the  following  information: 

•  UIC  (the  account  number) 

•  Password 

•  User's  default  system  device 

•  First  name 

•  Last  name 

•  User's  Command  Line  Interpreter  (CLI)  if  the  system  has 
multi-CLI  support 

•  Date  and  time  of  the  user's  most  recent  login 

•  The  number  of  times  that  the  user  has  logged  in  to  the  system 

•  Whether  the  user's  terminal  is  to  be  slaved  after  login 

•  On  RSX-11M-PLUS  systems,  a  session  identifier 

•  On  RSX-1 1M-PLUS  systems,  the  user  account  number 


2.2  INVOKING  ACNT 

Invoke  ACNT,  from  a  privileged  terminal,  as  follows: 
>RUN  $  ACNT  (RET) 
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ACNT  identifies  itself  and  displays  a  list  of  options  after  you  type 
the  RUN  command. 

A  nonpr ivileged  user  can  use  ACNT  only  to  modify  the  account  entry  for 
his  or  her  password.  (See  the  RSX-11M/M-PLUS  MCR  Operations  Manual) . 


2.3  ACNT  OPTIONS 

ACNT  is  an  interactive  program  that  allows  privileged  users  the 
following  options : 

•  (C)  Create  an  account  file. 

•  (A)  Add  accounts  to  the  file. 

•  (E)  Examine  individual  account  entries  in  the  file. 

•  (M)  Modify  individual  account  entries  in  the  file. 

•  (L)  List  account  entries  in  the  file. 

•  (D)  Delete  account  entries  from  the  file. 

•  (S)  Sort  the  account  entries  in  the  file. 

•  (CTRL/Z)  Exit  from  ACNT. 

ACNT  prompts  you  for  an  option.  Enter  one  of  the  letters  indicated  in 
the  parentheses  above.  The  program  responds  by  requesting  further 
input  or  by  displaying  information  for  the  option  you  selected.  The 
remainder  of  this  chapter  discusses  the  ACNT  options  and  includes 
examples  of  each. 


2.3.1  Creating  the  Account  File 

The  Create  option  lets  you  create  the  account  file.  Create  the 
account  file  immediately  after  generating  your  system  to  allow  normal 
use  of  the  system.  The  Create  option  allocates  the  account  file 
( LB : [ 0 , 0] RSX1 1 • SYS)  and  sets  the  file  protection  so  that  only 
privileged  users  and  privileged  tasks  can  access  the  account  file. 

You  may  copy  and  optionally  extend  the  account  file  using  the 
Peripheral  Interchange  Program  (PIP)  (see  the  RSX-11M/M-PLUS  Utilities 
Manual)  .  The  new  copy  will  have  the  default  file  protection";  You 
should ,  therefore ,  immediately  run  ACNT.  ACNT  will  detect  the 
incorrect  protection  codes  and  restore  proper  protection. 

The  following  example  shows  how  to  create  the  account  file.  After  you 
invoke  ACNT ,  it  responds  with  a  list  of  options  and  a  prompt. 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  C  (ret) 

Enter  maximum  number  of  accounts:  35.  (ret) 

Enter  a  decimal  number  (n.)  to  specify  the  maximum  number  of  account 
entries  to  be  listed  in  the  file.  The  system  then  creates  an  account 
file  ( LB : [ 0 , 0] RSX1 1 . SYS)  large  enough  to  contain  35  accounts. 
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When  the  Create  operation  is  complete ,  press  the  ESCAPE  key  to  request 
a  list  of  options.  Then  you  can  add  accounts  to  the  account  file. 


2.3.2  Adding  Account  Entries 

The  Add  option  lets  you  add  accounts  to  the  account  file.  ACNT 
prompts  you  for  the  following: 

•  UIC  (the  account  number). 

•  Password. 

•  User's  default  system  device. 

•  First  name  .  . 

•  Last  name. 

•  User's  CLI.  If  your  system  does  not  have  multi-CLI  support, 
ACNT  does  not  prompt  you  for  the  user's  CLI  ( MCR  is  the 
default)  . 

•  Whether  the  user's  terminal  is  to  be  slaved  after  login. 

•  On  RSX-1 1M-PLUS  systems,  a  session  identifier. 

•  On  RSX-1 1M-PLUS  systems,  a  user  account  number. 

ACNT  maintains  the  file  in  ascending  order  by  UIC. 

The  prompts  for  the  password,  first  name,  and  last  name  specify  the 
maximum  number  of  characters  that  ACNT  accepts.  The  legal  characters 
for  user  names  and  passwords  are  as  follows: 

•  A  through  Z,  upper-  and  lowercase 

•  0  through  9 

•  '  (apostrophe) 

•  .  (period) 

•  -  (hyphen) 

•  $  (dollar  sign) 

•  !  (exclamation  point) 

The  default  system  device  prompt  requests  a  device  name  and  unit 
number  (optional  if  0).  ACNT  accepts  logical,  physical,  and  pseudo 
device  names.  The  acceptance  of  logical  and  pseudo  device  names  lets 
you  move  the  user  disk  to  another  drive  without  having  to  change  the 
default  device  in  the  account  file.  When  specifying  the  device  name, 
do  not  include  a  colon  (:). 


RSX-1 1M-PLUS  systems  include  two  additional  prompts:  one  is  for  a 
session  identifier  and  the  other  is  for  the  user  account  number.  The 
session  identifier  and  user  account  number  are  optionally  used  by  the 
Resource  Accounting  Program  (see  Chapter  17).  The  session  identifier 
is  also  used  by  the  HELLO  program  (see  the  RSX- 11 M/M- PLUS  MCR 
Operations  Manual) . 
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The  following  example  shows  how  to  add  entries  to  the  account  file  on 
RSX-11M-PLUS  systems: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  A® 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,15® 

Password  (  <=6  chars.  ) :  A1B2C3  ® 

Default  system  device  (  DDU  ):  DB ® 

First  name  (  <=12  chars.  ) :  JANE  ® 

Last  name  (  <=14  chars.  ):  BARRETT® 

Enter  user  CLI  (default=MCR) :  DCL  ® 

Slave  terminal?  [Y/N] :  N  ® 

Session  ident  (  3  chars.  ):  REC  ® 

Account  number  (  <=4  digits  ):  117® 

UFD  DB1 : [005,015] 

In  the  previous  example,  ACNT  creates  an  account  in  the  account  file 
for  Jane  Barrett.  Jane's  password  is  A1B2C3,  her  default  system 
device  is  DBO:,  her  CLI  is  DCL,  and  her  terminal  is  not  slaved  after 
login.  Jane's  session  identifier  is  REC  and  her  account  number,  117. 

On  an  RSX-11M  system,  this  option  adds  accounts  to  the  account  file  in 
the  same  manner. 

ACNT  remains  in  Add  mode  until  you  press  the  ESCAPE  key  to  request  a 
list  of  options. 


2.3.3  Examining  Account  Entries 

The  Examine  option  displays  two  lines  of  detailed  information  for  each 
account  in  the  account  file.  The  first  line  contains,  from  left  to 
right,  the  following  information: 

•  UIC 

•  Password 

•  First  name 

•  Last  name 

•  User's  default  system  device 


>  On  RSX-m 

I-PLUS  systems,  a 

session  ident 

if  ier 

The  second  line  contains  the  following  information: 

•  On  RSX-11M-PLUS  systems,  a  user  account  number. 

•  Date  of  the  last  login. 

•  Time  of  the  last  login. 

•  Number  of  times  the  user  has  logged  in  to  the  system. 

•  User's  CLI.  If  your  system  does  not  have  multi-CLI  support, 
ACNT  displays  the  default  CLI  (MCR) . 

•  Whether  the  user's  terminal  is  to  be  slaved  after  login. 
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The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-11M  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  E® 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,14® 

[005,014]  007  SEAN  CONNOIT  DB0 : 

03/05/81  15:05:55  00001  DCL  N 

In  this  example,  Sean  Connoit's  account  is  examined.  The  first  line 
lists  his  UIC  ([005,014]),  password  (007),  first  name,  last  name,  and 
default  system  device  (DB0:).  The  second  line  displays  the  date  of 
his  last  login  (03/05/81),  the  time  of  his  last  login  (15:05:55),  the 
number  of  times  he  has  logged  in  (00001) ,  his  CLI  (DCL) ,  and  the 
slave/no-slave  status  of  his  terminal  (N) . 

The  following  example  shows  how  to  display  information  for  an  account 
on  an  RSX-11M-PLUS  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  E<RET> 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,5® 


[005,005] 

SKIP 

JOHN 

MORAN 

DB1 : 

MGR 

0111 

03/06/81 

08:36:57 

00002  DCL  N 

In  this  example, 

John  Moran’s  account  is  examined. 

His  account 

includes  two  additional  information  fields,  a  session  identifier  (MGR) 
and  a  user  account  number  (0111)  . 

ACNT  remains  in  Examine  mode  until  you  press  the  ESCAPE  key  to  request 
a  list  of  options. 


2.3.4  Modifying  Account  Entries 

The  Modify  option  allows  you  to  change  the  password,  default  system 
device,  first  name,  and  last  name  for  an  account,  and  the 
slave/no-slave  status  of  a  terminal.  You  can  change  the  CLI  of  an 
account  if  your  system  includes  the  multi-CLI  option. 

In  an  RSX-1 1M-PLUS  system,  the  Modify  option  also  allows  you  to  change 
the  session  identifier  and  the  account  number. 

After  you  specify  the  account  to  be  modified,  the  program  displays  an 
account  entry  and  asks  for  verification.  Type  either  Y  (Yes)  or  N 
(No)  to  indicate  that  the  correct  account  was  or  was  not  specified. 
If  you  specify  N,  ACNT  searches  the  file  for  another  entry  with  the 
same  UIC.  When  you  enter  a  Y,  ACNT  prompts  for  the  entry  details. 
Press  the  ESCAPE  key  if  you  do  not  want  to  change  an  item. 


2-5 


THE  ACCOUNT  FILE  MAINTENANCE  PROGRAM  ( ACNT) 


The  following  example  shows  how  to  modify  account  information 
RSX-11M  system: 


on  an 


Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  M  © 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,12® 

[005,012]  BARB  BARBARA  SPENCER  DBO : 

03/05/81  15:00:11  00006  MCR  N 

This  entry  ?  [Y/N]  :  y® 

Type  <ESC>  to  leave  entry  unchanged 
Password  (  <  =  6  chars.  ):  BES © 

Default  system  device  (  DDU  )  :  (esc) 

First  name  (  <=12  chars.  )  :  fsc) 

Last  name  (  <=14  chars.  )  :  fsc) 

Enter  user  CLI  (defaul t=MCR) :  DCLffl 
Slave  terminal?  [Y/N]:  (esc) 

In  this  example,  Barbara  Spencer's  account  is  modified.  Her  password 
(BARB)  is  changed  to  BES,  and  her  CLI  (MCR)  is  changed  to  DCL. 

The  following  example  shows  how  to  modify  account  information  on  an 
RSX-11M-PLUS  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  M® 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,6® 
r005,006]  LIZ  ELIZABETH  FORD  DB1 : 

SEC 

0112  03/06/81  08:37:47  00001  MCR  N 

This  entry  ?  [Y/N] :  N  ® 

[005,006]  MLH  MARY  HAZNAR  DBO: 

SEC 

0113  03/06/81  08:38:45  00001  DCL  N 

This  entry  ?  [Y/N]:  y® 

Type  <ESC>  to  leave  entry  unchanged 
Password  (  <=6  chars.  )  :  (esc) 

Default  system  device  (  DDU  )  :  fsc) 

First  name  (  <=12  chars.  )  :  (esc) 

Last  name  (  <=14  chars.  )  :  fsc) 

Enter  user  CLI  (defaul t=MCR)  :  f$g 
Slave  terminal?  [Y/N] :  Y  ® 

Session  ident  (  3  chars.  );  REC  ® 

Account  number  (  <=4  digits  )  :  H6  ® 

In  this  example,  Mary  Haznar's  account  is  modified.  Her  terminal  is 
changed  to  a  slaved  terminal,  her  session  identifier  (SEC)  is  changed 
to  REC,  and  her  account  number  (0113)  is  changed  to  116. 

ACNT  remains  in  Modify  mode  until  you  press  the  ESCAPE  key  to  request 
a  list  of  options. 


2.3.5  Listing  Account  Entries 

The  List  option  either  displays  on  the  user's  terminal  or  spools  to 
the  line  printer  all  account  entries  in  the  account  file  or  a 
specified  group  of  entries.  If  you  specify  the  line  printer,  ACNT 
creates  the  file  ACCNT.DMP.  This  file  contains  the  account 
information  you  specified.  ACNT  prints  the  file  if  the  spooler  is 
installed  in  your  system.  If  the  spooler  is  not  installed,  you  may 
print  ACCNT.DMP  after  you  exit  from  ACNT. 
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The  following  example  shows  how  to  list  account  entries  on  an 
RSX-1 1M-PLUS  system: 


Options  a 

re : 

A  -  ADD, 

c  -  CREATE 

FILE,  D  -  DELETE,  E 

-  EXAMINE, 

L  -  LIST, 

M 

-  MODIFY, 

S  -  SORT, 

CTRL/Z  -  EXIT 

Enter  option 

:  L  © 

Print  passwords?  [Y/N] 

:  Y  ® 

All  accounts?  [Y/N]:  N© 

Enter  group 

number  (N) 

:  5© 

Enter  T  - 

TERMINAL  or 

L  -  SPOOLED  LINEPRINTER: 

T® 

[005,005] 

SKIP 

JOHN 

MORAN 

DB1 :  MGR 

0111 

03/06/81 

08:36:57 

00002  DCL 

N 

[005,006] 

LIZ 

ELIZABETH 

FORD 

DB1 :  SEC 

0112 

03/06/81 

08:37:47 

00001  MCR 

N 

[005,006] 

MLH 

MARY 

HAZNAR 

DB0 :  REC 

0116 

03/06/81 

08:38:45 

00001  DCL 

Y 

[005,015] 

A1B2C3 

JANE 

BARRETT 

DB0:  REC 

0117 

03/09/81 

10:32:53 

00001  DCL 

N 

In  the  previous  example,  ACNT  lists  all  the  account  entries,  for  group 
5,  at  the  terminal. 

On  RSX-1 1M  systems,  this  option  lists  accounts  in  the  same  manner. 

When  the  list  operation  is  complete,  ACNT  displays  its  options  and 
prompts  for  a  choice. 


2.3.6  Deleting  Account  Entries 

The  Delete  option  eliminates  individual  accounts  from  the  file.  After 
you  specify  the  account  to  be  deleted,  ACNT  displays  the  account  entry 
and  requests  a  Y  (Yes)  or  N  (No)  response  for  verification.  If  the 
response  is  N,  ACNT  searches  for  another  account  with  the  same  UIC. 
If  the  response  is  Y,  ACNT  asks  if  you  want  to  delete  the  account's 
UFD  and  other  files.  Another  Y  response  deletes  these  files.  If  you 
enter  N  in  response  to  the  deletion  query,  the  account's  files  and  UFD 
are  left  intact. 

The  following  example  shows  how  to  delete  accounts  from  the  account 
file  on  an  RSX-11M  system: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E 
L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  D© 

Enter  account  or  <ESC>  for  options  (  N , N  ):  5,12® 

[005,012]  MLK  MAUREEN  KACZKA 

03/06/81  08:46:51  00004  DCL  N 

This  entry  ?  [Y/N]  :  Y® 

Delete  UFD  and  files?  [Y/N]:  Y® 

PIP  DB1: [005,012]*.*; */DE 
>PIP  DB1: [0,0] 005012. DIR;*/DE 

In  the  previous  example,  ACNT  deletes  Maureen  Kaczka's  UFD  and  files. 

On  an  RSX-11M-PLUS  system,  this  option  deletes  accounts  in  the  same 
manner . 


-  EXAMINE, 


DB1 : 


ACNT  remains  in  Delete  mode  until  you  press  the  ESCAPE ' key  to  request 
a  list  of  options. 
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2.3.7  Sorting  the  Account  Entries 

The  Sort  option  sorts  the  account  entries  in  ascending  order  by  UIC. 
The  following  example  shows  how  to  sort  the  account  file  on 
RSX-11M/M-PLUS  systems: 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
Enter  option:  S® 

When  the  sort  operation  is  complete,  ACNT  displays  all  its  options  and 
prompts  for  a  choice. 


2.3.8  Exiting  from  ACNT 

The  Exit  option  allows  you  to  exit  from  the  ACNT  program.  The 
following  example  shows  how  to  exit  from  ACNT  on  RSX-11M/M-PLUS 
systems : 

OPTIONS  ARE:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE,  E  -  EXAMINE, 

L  -  LIST,  M  -  MODIFY,  S  -  SORT,  CTRL/Z  -  EXIT 
ENTER  OPTION:  (ctrl/z)  (ret) 

When  you  exit  from  ACNT,  ACNT  displays  the  following  messaqe  on  your 
terminal : 

OPERATION  COMPLETE 


2.4  ERROR  MESSAGES 

The  ACNT  program  returns  the  following  error  messages: 

ACNT  —  Account  already  exists 

Explanation:  You  attempted  to  add  an  account  with  a  UIC  and 

password  that  already  exists  in  the  account  file. 

ACNT  —  Account  file  already  exists 

Explanation:  You  attempted  to  create  an  account  file  that 

already  exists. 

ACNT  —  Account  file  error 

Explanation:  The  program  detected  an  I/O  error  while 

processing  the  account  file. 

ACNT  —  Account  file  full 

Explanation:  The  account  file  is  full;  you  cannot  add 

further  accounts.  See  the  description  of  the  Create  option 
for  details  on  how  to  enlarge  the  account  file. 

ACNT  —  Cannot  find  account 

Explanation:  You  attempted  to  delete,  examine,  or  modify  an 

account  that  does  not  exist. 
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ACNT  —  Invalid  default  device  name 

Explanation:  The  default  system  device  specified  is  not  a 

directory  device. 

ACNT  —  Warning  **  Device  does  not  exist  on  current  system.  OK? 
[Y/N] : 

Explanation:  The  specified  default  device  is  not  in  the 
system.  If  you  enter  Y,  ACNT  retains  the  device  name  as  a 
logical  device  name.  ACNT  prompts  again  for  the  device  name 
if  you  enter  N. 

ACNT  —  Invalid  option 

Explanation:  In  response  to  the  prompt  Enter  option:,  you 

did  not  specify  A,  C,  D,  E,  L,  M,  S,  or  CTRL/Z,  which 
represent  valid  ACNT  options. 

ACNT  —  Listing  file  error 

Explanation:  When  you  use  the  List  option,  ACNT  opens  the 

file  SY: [current  uic] ACCNT. DMP.  This  message  indicates  that 
ACNT  cannot  open  the  file;  for  example,  the  device  is  full 
or  it  does  not  contain  a  UFD  for  the  current  UIC.  If  the 
device  is  full,  delete  some  files.  Create  a  new  UFD  if 
there  is  no  UFD  for  the  current  UIC. 

ACNT  —  Syntax  or  command  input  error 

Explanation:  You  typed  an  invalid  character.  Enter  the 

correct  data. 

ACNT  —  Workfile  -  dyn.  mem.  exhausted 

Explanation:  There  is  insufficient  dynamic  memory.  Install 

the  task  in  a  larger  partition,  or  install  it  with  a  larger 
increment . 

ACNT  —  Workfile  -  virtual  storage  exceeded 

Explanation:  The  workfile  exceeds  virtual  memory. 


CHAPTER  3 

THE  CONSOLE  LOGGER 


The  Console  Logger  consists  of  a  driver  (CODRV)  and  a  task  (COT,..) 
that  handle  I/O  to  the  console  output  device  (CO:)  and  record 
time-stamped  system  messages  on  a  terminal  or  in  a  log  file  or  both. 
You  select  support  for  console  logging  in  SYSGEN. 

For  RSX-11M  systems,  console  logging  is  available  only  on  mapped 
systems. 


3.1  THE  CONSOLE  OUTPUT  DEVICE  (CO:) 

Your  system  has  a  console  output  device  (CO:)  and  a  console  terminal. 
When  the  Console  Logger  is  active,  I/O  to  CO:  is  controlled  by  the 
console  output  task  (COT...)  and  the  console  driver  (CODRV).  When  the 
Console  Logger  is  not  active,  CO:  is  a  pseudo  device,  and  I/O  to  CO: 
is  controlled  by  the  terminal  driver.  In  both  cases,  output  to  CO: 
can  be  forwarded  to  a  terminal  that  you  assign  as  the  console 
terminal . 


3.1.1  CO:  as  a  Pseudo  Device 

When  the  Console  Logger  is  not  active,  CO:  is  a  pseudo  device.  You 
can  redirect  CO:  to  any  terminal  on  your  system  using  the  MCR 
REDIRECT  command.  The  terminal  driver  controls  all  I/O  to  CO:  that 
is  redirected  to  the  console  terminal. 


3.1.2  CO:  with  the  Console  Logger  Active 

When  the  Console  Logger  is  active,  the  console  driver  (CODRV)  and  the 
console  output  task  (COT...)  control  all  I/O  to  CO:.  You  use  a 
console  logging  command  to  assign  the  console  terminal  (see  Section 
3.4.5)  rather  than  redirecting  CO:  with  the  MCR  REDIRECT  command. 


There  are  two  advantages  to  using  the  console  logger  to  control  I/O  to 
CO:.  These  are  as  follows: 


1. 


Console  logging  allows  you  to  record  messages  sent 
a  log  file.  You  can  record  messages  on  the  conso 
and  in  the  log  file,  only  on  the  console  terminal, 
the  log  file.  This  flexibility  enables  you  to 
log  file  at  any  time  and  to  free  a  terminal  when  y 
need  an  on-line  display  of  console  logging. 


to  CO:  in 
le  terminal 
or  only  in 
inspect  the 
ou  do  not 
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2.  The  console  logger  time-stamps  messages  to  CO:  that  have  not 
been  time-stamped  by  the  task  issuing  the  message  in  the 
form : 

hh:mm:ss  hours,  minutes,  and  seconds. 

Also,  prior  to  outputting  the  first  message  after  a  change  of 
date,  the  Console  Logger  outputs  the  current  time  and  date. 


3.2  INSTALLING  COT...  AND  LOADING  CODRV 

If  you  select  console  logging  in  SYSGEN,  SYSGEN  installs  the  console 
output  task  (COT...)  and  loads  the  console  driver  (CODRV)  by  including 


the 

COT. 

appropriate 
. .  and  load 

commands  in  SYSVMR.CMD. 
CODRV  if: 

You 

only 

need 

to 

install 

1.  You  have  removed  one  or  both  of 

them 

and 

want 

to 

restore 

console  logging. 


2.  You  have  altered  SYSVMR.CMD  to  eliminate  them. 


3.3  COMMUNICATING  WITH  THE  CONSOLE  LOGGER 

You  can  use  the  COT...  task  to  communicate  with  the  Console  Logger. 
Tasks  use  the  CODRV  driver  to  communicate  with  the  Console  Logger. 


3.3.1  User  Communication  with  the  Console  Logger 

COT...  is  a  privileged  task.  From  a  privileged  terminal,  you  issue 
console  logging  commands  to  start  and  stop  console  logging,  assign  the 
console  terminal,  and  specify  the  console  log  file.  Table  3-1 
summarizes  the  console  logging  commands.  There  are  no  DCL  equivalents 
for  the  console  logging  commands.  Section  3.4  discusses  each  console 
logging  command  in  detail. 


3.3.2  Task  Communication  with  the  Console  Logger 

Tasks  communicate  with  the  console  driver  (CODRV)  by  issuing  QIOs. 
CODRV  handles  QIOs  to  CO:  for  reading,  writing,  attaching,  and 
detaching.  All  other  I/O  functions  to  CO:  are  passed  to  the  terminal 
driver  as  if  they  were  issued  directly  to  the  console  terminal. 


3. 3. 2.1  Writing  to,  CO:  -  Tasks  can  issue  QIOs  to  write  system 
messages  to  the  console  terminal  and/or  console  log  file.  For 
example,  HELLO  issues  a  QIO  to  write  a  message  to  the  console  terminal 
each  time  a  user  logs  in  to  the  system. 

Messages  to  CO:  may  begin  with  a  CTRL/G  to  ensure  that  COT...  sends 
the  message  to  the  most  recently  assigned  console  terminal  even  if  you 
have  disabled  the  console  terminal  using  the  NOCOTERM  option 
(discussed  in  Section  3.4.4). 

The  buffer  in  COT...  accepts  messages  not  longer  than  256(10)  bytes. 
(Setting  the  buffersize  of  device  CO:  with  the  MCR  SET  /BUFFERSIZE 
command  has  no  affect  on  this  restriction.) 
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Table  3-1 

Summary  of  Console  Logging  Commands 


MCR  Command 

Meaning 

SET  /COLOG 

Displays  the  current 
console  terminal  and 
logf ile  assignments . 

SET  / COLOG=ON 

Starts  console  logging. 

SET  /COLOG=OFF 

Stops  console  logging. 

SET  /COLOG/NOC [OTERM] 

Disables  the  console 
terminal . 

SET  /COLOG/COT [ERM] [=TTnn:] 

Changes  the  console 
terminal  assignment . 

SET  /COLOG/NOLOGFILE 

Disables  the  logfile. 

SET  /COLOG/LOG [FILE1 [= [ f i lespec] ] 

Changes  the  logfile 
assignment . 

3. 3. 2. 2  Reading  from  CO:  -  Tasks  can  issue  QIOs  to  read  input  from 
the  console  terminal.  For  example,  an  operator  can  use  the  console 
terminal  to  respond  to  prompts  by  a  system  task  that  require  user 
input.  COT...  does  not  record  messages  in  the  log  file  that  are  read 
from  the  console  terminal. 


3. 3. 2. 3  Attaching  and  Detaching  CO:  -  Tasks  may  attach  to  CO:; 
however ,  the  attach  is  a  NOP.  Though  tasks  may  attach  or  detach  CO: 
they  are  not  allowed  exclusive  access  to  CO:. 


3.4  COMMAND  DESCRIPTIONS 


You  use 


console  logging  commands  to  perform  the  following  functions: 
Display  the  current  console  terminal  and  log  file  assignments 
Start  and  stop  console  logging 

Change  the  console  terminal  and  log  file  assignments 
Disable  the  console  terminal  or  the  log  file 


3-3 


THE  CONSOLE  LOGGER 


The  general  format  of  console  logging  commands  in  MCR  is: 
>SET  /COLOG [MCRoption] . . . 

SET 

The  MCR  SET  command. 

COLOG 


Console  logging  keyword. 

MCRoption 

One  of  the  console  logging  functions.  You  can  truncate  these 
options  to  three  letters. 


3.4.1  Displaying  the  Current  Console  Terminal  and  Log  File  Assignments 

To  display  the  current  console  terminal  and  log  file  assignments, 
type : 


>SET  /COLOG 

Use  this  option  to  determine  if  the  Console  Logger  is  active.  When 
the  Console  Logger  is  active,  COT...  displays  the  current  console 
terminal  and/or  log  file  assignments.  For  example: 

>SET  /COLOG 
COT  — 

Console  =  TT000: 

Logfile  =  DB000 :[ 1 , 4 ] CONSOLE . LOG ; 1 

If  the  Console  Logger  is  not  active,  the  display  option  indicates  the 
following : 

COT  — 

Console  =  None 
Logfile  =  None 


3.4.2  Starting  Console  Logging 

The  following  command  line  starts  console  logging: 

>SET  / COLOG=ON 

When  you  start  console  logging,  COT...  retains  the  current  console 
terminal  assignment.  If  you  have  just  booted  the  system, 
COT. ..  assigns  CO:  to  TTO : .  The  default  location  and  name  of  the  log 
file  is  LB :[ 1 , 4 ] CONSOLE . LOG .  COT...  always  creates  a  new  version  of 
the  default  log  file  when  you  start  console  logging. 
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3.4.3  Stopping  Console  Logging 

The  following  command  line  stops  console  logging: 

>SET  / COLOG=OFF 

When  you  stop  console  logging,  the  current  console  terminal  assignment 
is  retained.  Use  the  MCR  DEV  command  to  display  the  current  console 
terminal.  Section  3.5  discusses  how  you  can  use  the  MCR  DEV  command 
to  monitor  how  CO:  is  redirected. 


NOTE 


Do  not  abort  COT....  Aborting  COT... 
causes  severe  pool  fragmentation. 


3.4.4  Disabling  the  Console  Terminal 
To  disable  the  console  terminal,  type: 

>SET  /COLOG/NOC [OTERM] 

This  command  line  enables  you  to  maintain  a  log  file  of  system 
messages  without  using  a  terminal  as  the  console  terminal.  This  is 
especially  useful  if  your  system  does  not  have  many  terminals  or  if 
you  cannot  spare  a  terminal  to  dedicate  to  receiving  system  messages. 

You  can  disable  the  console  terminal  by  assigning  the  console  terminal 
to  the  null  device  (NL:). 

Once  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option, 
the  command 

>SET  /COLOG/COTERM 

restores  the  most  recent  console  terminal  assignment. 


3.4.5  Reassigning  the  Console  Terminal 

The  following  command  line  reassigns  the  console  terminal: 

>SET  /COLOG/COT [ERM] [=TTnn: ] 

where  TTnn:  is  the  newly  assigned  console  terminal.  When  you  boot 
your  system,  the  default  console  terminal  assignment  is  TTO : •  When 
you  start  console  logging,  the  default  console  terminal  assignment  is 
the  current  console  terminal. 


3.4.6  Disabling  the  Log  File 
To  disable  the  log  file,  type: 

>SET  /COLOG/NOLOGFILE 

This  command  line  enables  you  to  continue  recording  system  messages 
time-stamped  by  COT...  at  the  console  terminal  without  recording  the 
messages  in  a  log  file. 
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3.4.7  Reassigning  the  Log  File 


The  following  command  line  reassigns  the  log  file: 
>SET  /COLOG/LOG [FILE] [=[filespec] ] 


where  filespec  is  any  legal  file  specification  as  described  in  the 
RSX-11M/M-PLUS  Uti 1 i ties  Manual.  The  default  filespec  is 
LB: [1,4] CONSOLE . LOG . 


To  change  only  part  of  the  log  file  filespec, 
the  filespec  after  the  equal  sign  that 
example,  if  LB:  is  DRO:  and  you  want 

DBO : [301,55] CONSOLE . LOG ,  type: 


type  only  that  part  of 
you  want  to  change.  For 
to  make  the  log  file 


>SET  /COLOG/LOGFILE=DBO: [301,55] 


If  you  want  to  make  the  log  file  TESTLOG.LOG  in  the  default  UIC  on 
LB:,  type 


>SET  /COLOG/LOG F I LE=TESTLOG 


In  all  cases,  COT  fills  in  the  missing  parts  of  the  filespec  with 
parts  from  the  default  filespec,  LB: [1 , 4] CONSOLE. LOG,  and  creates  a 
new  version  of  the  log  file. 

To  create  a  new  version  of  the  current  log  file,  type: 

>SET  / COLOG/LOG FI LE= 

If  you  have  disabled  the  log  file  with  the  NOLOGFILE  option,  this 
command  line  restores  the  most  recent  log  file  assignment.  Although  a 
new  version  of  the  log  file  is  created,  the  rest  of  the  filespec  does 
not  change. 

To  change  the  log  file  back  to  the  default,  type: 

>SET  /COLOG/LOGFILE 

This  command  line  creates  and  opens  a  new  version  of  the  default  loq 
file. 


3.4.8  Using  Multiple  Console  Logging  Commands 

You  can  use  multiple  console  logging  commands  in  a  command  line.  The 
following  command  line  starts  console  logging,  assigns  the  console 
terminal  to  TT17:,  and  opens  a  log  file  named  TESTLOG . TST  in  the 
default  UFD  on  LB: 

>SET  / COLOG=ON/COTERM=TT17 :/LOGFILE=TESTLOG . TST 

The  following  command  line  disables  the  console  terminal  and  restores 
the  log  file  to  the  default: 

>SET  /COLOG/NOCOTERM/LOGFILE 
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3.5  MONITORING  THE  STATUS  OF  CO: 

To  use  the  MCR  DEV  command  to  determine  the  status  of  CO: , 
console  logger  is  active,  enter: 

>DEV  CO: 


while  the 


The  system  responds: 


COO:  LOADED 

This  response  means  that  the  console  driver  (CODRV)  is  loaded  and  that 
COT...  handles  system  messages  to  CO:. 

Use  the  console  logging  display  option  to  display  the  console  terminal 
assignment : 

>SET  /COLOG 


If  you  have  disabled  console  logging,  use  the  MCR  DEV  command  to 
determine  the  terminal  assigned  as  CO: 

>DEV  CO: 

COO:  TTnn: 

where  nn  is  the  terminal  to  which  the  CO:  pseudo  device  is 

redirected . 

Before  COT...  exits,  it  redirects  CO:  to  the  current  console 

terminal.  If  there  is  no  console  terminal  (because  you  disabled  it 
with  the  NOCOTERM  option)  when  you  stopped  console  logging,  then  CO: 
is  redirected  to  the  last  terminal  COT...  assigned  as  the  console 
terminal.  In  this  case,  the  terminal  driver  handles  messages  directed 
to  CO:  and  redirects  them  to  TTnn:. 

If  you  have  disabled  the  console  terminal  with  the  NOCOTERM  option  but 
continue  to  record  system  messages  to  CO:  in  a  log  file,  then  use  the 
MCR  DEV  command  to  determine  the  status  of  CO: 


>DEV  CO: 

COO:  LOADED 


This  response  means  that  the  console  driver  is  loaded  and  that 
COT...  handles  all  messages  directed  to  CO:;  however,  system  messages 
are  not  directed  to  a  terminal.  Use  the  display  option  to  verify  that 
CO:  is  not  assigned  to  a  terminal. 


3.6  REDIRECTING  CO:  WITH  THE  MCR  REDIRECT  COMMAND 

Use  the  MCR  REDIRECT  command  to  redirect  CO:  to  a  terminal  only  when 
the  console  logger  is  not  active.  If  you  try  to  redirect  CO:  while 
the  console  logger  is  active,  you  will  receive  the  following  error 
message : 

>RED  —  Device  not  redirectable 
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For  example,  if  the  Console  Logger  is  active,  the  console  terminal  is 
assigned  to  TT2:,  and  you  stop  console  logging,  COT...  redirects  CO: 
to  TT2:  before  exiting.  Use  the  MCR  DEV  command  to  verify  that  CO: 
is  redirected  to  TT2 : •  To  assign  the  console  terminal  to  TTO :  use 
the  MCR  REDIRECT  command: 

>RED  TTO : =C0 : 

If  you  then  start  console  logging  again,  COT...  will  assign  TTO:  as 

the  console  terminal. 


NOTE 

Do  not  redirect  CO:  to  CO:. 


3.7  READING  THE  LOG  FILE 

Because  the  current  log  file  is  open  for  writing  if  LOGFILE  is 
enabled,  you  can  read  it  only  by  using  PIP  with  the  Shared  Read  (/SR) 
switch.  For  example,  if  the  log  file  is  DRO : [1 , 4] CONSOLE. LOG ,  and  you 
type 


>PIP  TI : =DR0 : [1,4]C0NS0LE. LOG 
PIP  responds: 


PIP  —  Open  failure  on  input  file 

DRO: [1 , 4] CONSOLE . LOG ? 1  —  Accessed  for  write 

To  read  the  log  file,  type: 

>PIP  TI:=DR0: [ 1 , 4 ] CONSOLE . LOG/SR 


A  sample  log  file  follows: 


16:43:19 

Logout 

user 

[1,4]  TT53 : 

16:43:35 

Login 

user 

ALPHA 

[7,334] 

TT53 : 

16:45:07 

Login 

user 

BRAVO 

[7,42] 

TT13 : 

16:46:21 

***  DM0 

1 :  — 

DISMOUNT  COMPLETE 

16:46:32 

Login 

user 

DECNET 

[240,240]  TT30 

16:47:22 

Login 

user 

CHARLIE 

[7,373] 

TT22 : 

16:47:38 

***  LPO 

:  — 

NOT  READY 

16:47:49 

Logout 

user 

[1,4]  TT53 : 

16:47:58 

Logout 

user 

[7,373]  TT22 : 

16:48:01 

Login 

user 

ALPHA 

[7,334] 

TT53 : 

16:49:40 

Login 

user 

DECNET 

[240,240]  HT0 : 

3.8  SAMPLE  CONSOLE  LOGGING  TERMINAL  SESSION 

Example  3-1  shows  a  console  logging  terminal  session  illustrating  how 
you  use  all  the  commands  described  in  the  previous  Sections  3.4 
through  3.7. 
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Example  3-1  Sample  Console  Logging  Terminal  Session 
(This  example  assumes  that  LB:  is  assigned  to  DBO:.) 


>SET  /COLOG 
COT  — 

Console  =  None 
Losfile  =  None 
DEV  co: 
coo:  tto : 

>SET  /COLOG=ON 

> D E v  co: 

COO:  LOADED 
>SET  /COLOG 
COT  -- 

Console  =  TTOOO: 

LoSfile  =  DB000:C1f43C0NS0LE*L0GU 
>SET  /C0L0G/CQTERM=TT5i: 

>SET  /COLOG/LOGFILE=DR: C301 f 55 3 TEST 
>SET  /COLOG 
COT  — 

Console  =  TT051: 

LoSfile  =  DR000JC301 f 553TEST ♦ LOG f 1 
>SET  /COLOG/NOCOT 
>SET  /COLOG 
COT  — 

Console  =  None 

LoSfile  =  DR000:C301f55DTEST*L0Gf1 

>dev  co: 

COO:  LOADED 

>SET  /COLOG/COTER/NOLOG 
>SET  /COLOG 
COT  — 

Console  =  TT051 
Loslfile  =  None: 

>SET  /COLOG/COTE RM=TT 17 :/LOG= 

>SET  /COLOG 
COT  -- 

Console  =  TT017: 

LoSfile  =  DR000:C301 f  55 3 TEST ♦  LOG  f  2 
>SET  /COLOG^OFF 
>SET  /COLOG 
COT  — 

Console  =  None 
Loslfile  =  None 

> d e v  co: 

coo:  tti7: 

>RED  TT5i:=C0: 

>DEV  co: 
coo:  TT5i: 

>SET  /C0L0G=0N/L0G=DB1 :C7f3011 
>SET  /COLOG 
COT  -- 

Console  =  TT051: 

Losfile  =  DB001:E!7f3013C0NS0LE*L0Gf1 
>SET  /CQLOG/COT~TTOl/LOG 
>SET  /COLOG 
COT  — 

Console  =  TTOOO: 

Losfile  =  DB000:C1f43C0NS0LE*L0Gf3 


(continued  on  next  page) 
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Example  3-1  (Cont.)  Sample  Console  Logging  Terminal  Session 


>P I P  TI ♦  =  LB  ♦  Cl *43C0NSOLE*LOG 
PIP  --  Open  failure  on  input  file 
DB0*C1j43CQNS0LE*L0G>3  —  Accessed 
>PIP  TI • -LB  t  C 1 f 4 3 CONSOLE ♦ LOG /SR 


for  write 


16*43*19 
1 6 : 43  1 35 
16*45*07 
16  M6  5  21 
16 : 46  *  32 
1 6  M7  J  22 
16M7J  38 
16M7M9 
16*47*58 
1 6  M8  *  01 
16M9M0 


Logout  user 
Login  user 
Login  user 
***  DM0 :  — 
Login  user 
Login  user 

***  lpo:  ~~ 

Logout  user 
Logout  user 
Login  user 
Login  user 


TT53  * 


Cl  f  43 
ALPHA 
BRAVO 
DISMOUNT 
DECNET 
CHARLIE 
NOT  READY 
Clr43  TT53  X 
C  7  f  373  3  TT22  * 
ALPHA 
DECNET 

>SET  /C0L0G/N0C0TERM/N0L0G 
COT  --  Not  logging  on  a  terminal 
>DEV  CO** 
coo:  TTO * 


C  7  f 334  3  TT53  * 
17*423  TT13J 
COMPLETE 

C  240  *  2403  TT30; 
C7  *3733  TT22  * 


17  r 334  3  TT53 : 

C 240  ?  240 3  HTO ♦ 


© 


© 


or  to  a  file*  COT  exit  ins 


© 


O  Displays  the  current  console  terminal  (none)  and  log  file 
(none)  assignments  indicating  that  the  Console  Logger  is  not 
active . 

©  Illustrates  the  MCR  DEV  command  that  shows  how  CO:  is 

redirected.  CO:  is  redirected  to  TTO : ,  which  means  that 

the  Console  Logger  is  not  active  and  that  the  terminal 
driver  redirects  CO:  to  TTO:. 

©  Starts  console  logging. 

©  Shows  that  the  Console  Logger  is  active  because  CODRV  is 
loaded.  The  display  option  shows  that  COT...  redirects  CO: 
to  TTO:  and  that  DBO :[ 1 , 4 ] CONSOLE . LOG ; 1  is  the  log  file. 
These  are  both  the  defaults  when  you  boot  your  system. 

©  Shows  how  you  assign  the  console  terminal  to  TT51:. 

©  Shows  how  you  assign  the  log  file  to  DR: [ 301 , 55] TEST. LOG . 
COT...  fills  in  the  missing  parts  of  the  filespec  with 
parts  from  the  default  filespec.  In  this  case, 

COT...  supplies  the  file  type. 

©  Displays  the  current  console  terminal  (TT51:)  and  log  file 
(DR : [ 301 , 551  TEST. LOG ; 1 )  assignments  resulting  from  command 
lines  5  and  6. 

©  Disables  the  console  terminal  and  retains  the  current  log 
file  (DR : [ 301 , 55] TEST. LOG ; 1 ) •  The  display  option  confirms 
this . 

©  Shows  that  when  you  disable  the  console  terminal  with  the 
NOCOTERM  option,  the  console  logger  is  still  active  (CODRV 
is  loaded),  but  CO:  is  not  redirected  to  any  terminal. 

©  Illustrates  the  multiple  commands  that  restore  the  most 
recent  console  terminal  assignment  (TT51:)  and  disable  the 
log  file.  The  display  option  confirms  this. 
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0  Illustrates  the  multiple  commands  that  assign  the  console 
terminal  to  TT17:  and  restore  the  most  recent  log  file. 

The  display  option  confirms  these  assignments.  The  log  file 
version  number  increments. 

0  Stops  console  logging.  The  display  option  confirms  that  the 
console  logger  is  not  active.  CO:  is  redirected  to  TT17:, 
which  was  the  last  console  terminal  assignment  before 
COT. . .  exited . 

0  Redirects  CO:  to  TT51:  with  the  MCR  REDIRECT  command  and 
confirms  this  with  the  MCR  DEV  command. 

©  Illustrates  multiple  commands  on  a  command  line.  Starts 
console  logging,  retaining  the  current  console  terminal 
assignment  (TT51:)  redirected  with  the  MCR  REDIRECT  command 
in  step  13f  and  opening  a  log  file 

DB001 : [7 , 301] CONSOLE. LOG ; 1 .  The  display  option  confirms 
these  assignments . 

0  Illustrates  multiple  commands  on  a  command  line.  Assigns 
the  console  terminal  to  TTO :  and  restores  the  default  log 
file.  The  display  option  confirms  these  assignments.  The 
version  number  of  the  log  file  increments. 

0  Illustrates  what  happens  when  you  try  to  read  an  open  log 
file  without  the  Shared  Read  switch  (/SR) . 

0  Shows  how  to  read  an  open  log  file  using  the  Shared  Read 

switch.  Each  message  in  the  log  file  begins  with  a  time 
stamp. 

0  Disables  the  console  terminal  and  the  log  file. 

COT...  exits  because  no  console  logging  is  in  progress. 
COT...  displays  a  message  informing  you  that  it  is  exiting. 
The  MCR  DEV  command  shows  that  CO:  is  redirected  to  TTO:, 
the  console  terminal  assignment  before  COT...  exited. 


3.9  ERROR  MESSAGES 

COT  —  LUN  assignment  to  console  terminal  failed 

Explanation:  You  specified  an  incorrect  terminal  number  as  the 

console  terminal. 

User  Action:  Use  the  COTERM  option  to  assign  the  console 
terminal  to  a  terminal  in  your  hardware  configuration. 

COT  —  Illegal  console  terminal 

Explanation:  You  tried  to  assign  a  device  that  is  off  line  or  is 

not  a  terminal  to  CO:. 


On  RSX— 1 1M-PLUS  systems,  the  device  may  be  illegal  be 
a  spooled  terminal. 

cause  it  is 

User  Action:  Use  the  COTERM  option  to  assign  a  termi 
hardware  configuration  to  CO: 

nal  in  your 
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COT  —  Console  driver  not  loaded,  COT  exiting 

Explanation:  The  console  driver,  CODRV,  is  not  loaded. 

User  Action:  Load  the  console  driver  and  start  console  logging. 

COT  —  Maximum  consecutive  write  errors,  disabling  logfile 

Explanation:  An  error  occurred  on  five  consecutive  write 

operations  to  the  log  file.  COT...  closes  the  log  file  and 
disables  logging  to  the  log  file. 

User  Action:  Determine  the  problem  that  caused  the  write  errors 
and  correct  it.  Then  restart  COT... 

COT  —  Not  logging  on  a  terminal  or  to  a  file,  COT  exiting 

Explanation:  You  have  disabled  the  console  terminal  with  the 

NOCOTERM  option  and  the  log  file  with  the  NOLOGFILE  option. 

User  Action:  If  you  did  not  intend  to  stop  console  logging, 
start  it  again  specifying  either  a  log  file,  console  terminal,  or 
both. 

COT  —  Unable  to  redirect  CO:  to  a  terminal  -  CO:  is  offline,  COT  exiting 

Explanation:  CO:  is  off  line.  There  is  a  problem  with  the  most 

recent  console  terminal  assignment.  It  may  be  off  line  or  not  a 
terminal . 

On  RSX-1 1M-PLUS  systems,  the  problem  may  be  that  a  spooled 
terminal  was  assigned. 


User  Action:  Start  COT...  and  specify  a  legal  console  terminal 
with  the  COTERM  option.  Then  stop  console  logging. 

COT  —  Syntax  error 

Explanation:  You  made  an  error  in  entering  a  console  logging 

command . 

User  Action:  Check  the  command  description  in  Section  3.4,  and 
enter  the  command  correctly. 

COT  —  Will  attempt  console  LUN  assignment  to  TTnn: 

Explanation:  This  error  message  may  occur  when  you  stop  console 

logging.  If  COT...  cannot  redirect  the  console  terminal  to  the 
terminal  currently  assigned  as  the  console  terminal,  it  tries  to 
redirect  CO:  to  the  previous  console  terminal  assignment.  If 

that  fails,  it  tries  TTO:.  If  that  fails,  it  generates  the  error 
message : 

$COT  —  LUN  assignment  to  console  terminal  failed 

User  Action:  Start  console  logging  again,  specifying  a  legal 
console  terminal.  Then  stop  console  logging. 
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COT 


COT 


—  Illegal  command  -  Console  logging  has  not  been  turned  on 

Explanation:  You  issued  a  console  logging  command  before 

starting  console  logging. 

User  Action:  Start  console  logging  and  issue  the  command. 

—  Logfile  x  error 

filespec  —  QIO  Error  Code  -nn. 


Explanation:  An  I/O  error  occurred  while  COT...  was  performing 
an  operation  on  the  log  file.  The  function  being  performed,  x, 
is  WRITE,  OPEN,  or  CLOSE.  The  filespec  is  any  legal  filespec 
designated  for  the  log  file.  The  error  code,  -nn.,  is  an  I/O 
Error  Code  described  in  the  IAS/RSX-11  I/O  Operations  Reference 
Manual. 


User  Action:  Look  up  the  I/O  Error  Code  in  the  IAS/RSX-11  I/O 
Operations  Reference  Manual  and  take  the  appropriate  action. 
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CHAPTER  4 


THE  I/O  EXERCISER  (IOX) 


The  I/O  Exerciser  (IOX)  detects  and  diagnoses  I/O  problems  on  the  disk 
and  tape  units  in  your  hardware  configuration.  Using  the  IOX  Command 
Language ,  you  can  execute,  control,  and  monitor  I/O  exercises  on 
device  units  that  you  specify  for  exercising. 

This  chapter  has  a  narrative  part  and  a  reference  part.  The  narrative 
part  presents  the  information  you  need  to  run  the  I/O  Exerciser  in  the 
order  you  need  that  information.  The  reference  part  describes  each 
command  in  the  IOX  Command  Language. 


4.1  INTRODUCTION 


This  section  serves  the  following  functions: 

•  Provides  an  overview  of  the  steps  involved  in  running  an  I/O 
exercise 

•  Describes  how  the  I/O  Exerciser  exercises  different  types  of 
devices 


•  Distinguishes  between  file-structured  and  nonfile-structured 
volumes 

•  Categorizes  the  IOX  commands  by  function 


4.1.1  Overview  of  the  Steps  Involved  in  Running  an  I/O  Exercise 
Before  you  run  an  I/O  exercise,  you  need  to  consider  the  following: 


•  Kinds  of  devices  to  exercise  (magnetic  tapes,  cassettes, 
disks,  and  DECtapes) 

•  Kind  of  exercise  to  run  for  each  device  (IOX  has  three  kinds 
of  exercises) 

•  Exercise  parameters  to  set  for  each  exercise  (such  as  whether 
or  not  to  test  random  blocks  on  disks,  how  many  records  to 
test  on  magnetic  tapes,  and  how  long  to  run  the  exercise) 


The  steps 
decisions 
Language , 


involved  in  running  an  I/O  exercise 
about  these  three  aspects  of  testing, 
you  implement  these  decisions  and  run 


include  your  making 
Using  the  IOX  Command 
an  exercise. 
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Running  an  I/O  exercise  consists  of  the  following  basic  steps: 

1.  Invoke  IOX. 

2.  Determine  which  devices  you  want  to  test  and  include  them  in 
your  "test  configuration." 

3.  Determine  the  kind  of  exercise  to  run  on  each  unit  in  your 
test  configuration . 

4.  Set  exercise  parameters  to  affect  how  IOX  tests  the  units  you 
want  to  exercise. 

5.  Begin  the  exercise  and  possibly  interrupt  the  exercise  to 
change  steps  2,  3,  and  4. 

<S.  Monitor  the  activity  and  error  reports  that  IOX  generates 
during  an  exercise. 

7.  Exit  IOX  or  repeat  this  process  beginning  at  step  2,  3,  4,  or 
5  as  appropriate. 


4.1.2  How  IOX  Exercises  Different  Types  of  Devices 

IOX  performs  IOX  exercising  on  disks,  magnetic  tapes,  cassettes,  and 
DECtapes.  You  can  use  IOX  to  exercise  any  disk  or  tape  unit  in  your 
hardware  configuration  that  has  a  mounted  volume  and  is  not  allocated 
to  another  user.  By  default,  IOX  can  exercise  28  units 

simultaneously.  You  can  edit  the  task  build  command  file  (see  Section 
4.11)  to  enable  IOX  to  test  as  many  as  250  units  simultaneously. 

In  general,  I/O  exercises  consist  of  four  steps: 

1.  Writing  1024.  bytes  of  data  made  up  of  a  specific  data 
pattern  to  a  mounted  volume 

2.  Reading  the  data  just  written 

3.  Checking  that  the  data  read  matches  the  data  written 

4.  Reporting  mismatches  of  data 

IOX  repeats  this  process  until  the  exercise  has  completed. 


4. 1.2.1  How  IOX  Exercises  Disks  -  IOX  writes  a  buffer  of  data  to  a 
disk  and  then  reads  that  data  from  the  disk.  You  can  set  exercise 
parameters  that  determine:  the  data  pattern  to  be  written,  the  range 
of  blocks  to  be  tested,  and  whether  to  test  blocks  sequentially  or 
randomly. 


4. 1.2. 2  How  IOX  Exercises  Magnetic  Tapes  and  Cassettes  -  IOX  uses  the 
same  algorithm  to  exercise  magnetic  tapes  and  cassettes.  IOX  rewinds 
the  tape,  writes  one  record,  space  reverses  one  record,  and  then  reads 
the  record  that  was  just  written.  This  repeats  until  the  number  of 
records  that  you  specified  for  testing  are  read.  At  the  end  of  the 
exercise,  IOX  writes  two  tape  marks  and  rewinds  the  tape.  If  you  are 
testing  more  than  one  unit,  IOX  continues  testing  on  those  units  while 
the  tape  is  rewinding.  You  can  set  exercise  parameters  that 
determine:  the  data  pattern  to  be  written,  the  size  of  the  data 
buffer,  and  the  number  of  records  to  be  exercised. 
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4. 1.2. 3  How  IOX  Exercises  DECtapes  -  IOX  exercises  DECtapes  by 
writing  forward/reading  forward,  then  writing  reverse/reading  reverse 
until  the  end  of  the  tape  is  reached.  IOX  exercises  DECtapes  using  a 
data  buffer  of  two  blocks  (1024.  bytes).  You  can  set  a  test 
parameter  only  to  determine  the  data  pattern  that  IOX  writes  to  the 
DECtape. 


4. 1.2. 4  Nonfile-Structured  and  File-Structured  Volumes  -  IOX  exer¬ 
cises  devices  with  two  kinds  of  volumes:  nonfile-structured  (NFS)  and 
file-structured  (Files-11) .  The  meanings  of  these  terms  may  differ 
slightly  from  other  manuals  within  the  RSX-11M/M-PLUS  set.  In  the 
context  of  the  I/O  Exerciser,  they  are  defined  as  follows.  All  tapes 
are  NFS  volumes.  (Throughout  this  chapter,  the  term  "NFS”  describes 
devices  and  the  testing  of  devices  that  contain  nonfile-structured 
volumes.)  Disks  can  be  either  NFS  or  Files-11  volumes.  Files-11 
volumes  are  only  those  disks  that  have  been  initialized  with  the  MCR 
INITIALIZE  command  and  therefore  have  a  home  block  and  a  Files-11 
structure . 


4.1.3  The  Four  Categories  of  IOX  Commands 

The  IOX  Command  Language  has  four  categories  of  commands: 

Function  Commands 

Select  devices  for  testing,  deselect  devices  from  testing,  and 
initiate  tasks  to  run  in  parallel  with  IOX. 

Control  Commands 

Start  and  stop  IOX  processing,  switch  IOX  modes  of  operation,  and 
exit  from  IOX  to  the  operating  system  monitor. 

Display  Commands 

Display  current  default  parameters,  get  help  text  for  IOX 
commands,  and  display  status  and  activity  reports  during  an  I/O 
exercise . 

Parameter  Commands 

Set  default  parameters  that  affect  how  IOX  tests  the  devices  you 
select  for  testing. 

Table  4-1  lists  the  IOX  commands  under  their  appropriate  categories. 


Table  4-1 

Four  Categories  of  IOX  Commands 


Function 

Control 

Display 

Parameter 

m 

DESELECT 

ABORT 

BADBLOCKS1 

BADBLOCKS1 

EXECUTE 

CTRL/C 

CONFIGURE1 

BUFFERSIZE 

FILES11 

EXIT 

DENSITY1 

COMPAREDATA 

SELECT 

PROCEED 

HELP 

CONFIGURE1 
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Table  4-1  (Cont.) 

Four  Categories  of  IOX  Commands 


Function 

Control 

Display 

Parameter 

VERIFY 

RESTART 

START 

PARAMETERLIST 

PATTERN1 

CONTROLS 

DENSITY1 

PRINTSUMMARY 

ERRORLIMIT 

RANGE1 

INTERLEAVE 

SPY 

LOGFILE 

PATTERN1 

RANDOM 

RANGE1 

RECORDS 

REPORTERRORS 

RETRIES 

RUNTIME 

SUMMARYTIME 

TEMPORARYFILE 

VOLUMECHECK 

WAIT 

WRITECHECK 

1.  These  commands  have  two  forms:  one  that  displays  the 
current  default  for  the  parameter  and  one  that  sets  the 
current  default  for  the  parameter. 


4.2  INSTALLING  AND  INVOKING  IOX 


IOX  is  task  built  as  a  nonprivileged,  checkpointable  task 
a  priority  of  50  in  the  GEN  partition.  You  can  run  IOX 
MCR  or  DCL  RUN  command  or  by  installing  and  invoking  IOX. 


that  runs  at 
by  using  the 


4.2.1  Installing  IOX 

Install  IOX  from  a  privileged  terminal  with  the  MCR  or  DCL  INSTALL 
command . 


For  RSX-11M  systems  that  do  not  support  the  Extend  Task  Directive  (see 
the  RSX-1 1M/M-PLUS  Executive  Reference  Manual) ,  install  IOX  with  an 
increment  large  enough  to  accommodate  all  buffers.  Assuming  all 
initial  IOX  defaults,  allocate  600.  words  per  unit  to  be  tested 
simultaneously.  For  example,  to  test  three  devices  simultaneously, 
install  IOX  as  follows: 

>INS  $IOX/INC=1800 . 

For  RSX-1 1M  systems  that  support  the  Extend  Task  Directive,  install 
IOX  without  an  increment. 

For  RSX-11M-PLUS  systems,  install  IOX  by  typing: 

>INS  $IOX 
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4.2.2  Invoking  IOX 

You  can  invoke  IOX  from  any  terminal. 

On  RSX-1 1M  single  user  systems,  mount  all  disks  that  you  want  to 
exercise  as  file-structured  disks.  If  you  have  a  multiuser  system, 
first  allocate  all  units  that  you  want  to  exercise.  Then  mount  only 


those  disks  that  you  want  to  exercise  as  file 

-structured  d 

mmiMJierojmji.iijii'it'i'i  ijii  ui'iir  mm . . 

isks 

• 

On  I 

exei 

for 

RSX-1 1M-PLUS  systems,  allocate  and  mount  a 
rcise.  Mount  nonfile-structured  volumes 

the  MOUNT  command. 

11  units  that  you 
using  the  /FOREIG1 

'  '  '  '  '  '  '  "  ’  . 

Vv 

NJ 

rant  to 
switch 

4. 2. 2.1  Invoking  an  Installed  Version  of  IOX  -  If  IOX  is  installed, 
invoke  it  with  the  command: 

>IOX 

IOX> 

IOX  responds  by  prompting  you  with  the  name  of  the  task  that  you 
assigned  to  IOX  when  you  installed  it.  If  you  did  not  specify  a  task 
name  when  you  installed  IOX,  its  task  name  is  ...IOX.  After  receiving 
the  prompt,  you  can  enter  IOX  commands. 


*4 . 2 . 2 . 2  Invoking  IOX  When  It  Is  Not  Installed  -  If  IOX  is  not 
installed,  invoke  it  with  the  MCR  or  DCL  RUN  command.  In  this  case, 
IOX  uses  your  terminal  number  to  name  the  task  and  prompts  you  using 
this  task  name.  For  example,  if  from  TT10:  you  type 

> RUN  $IOX 

you  will  be  prompted: 

TT1 0> 

When  you  receive  this  prompt,  you  can  enter  IOX  commands. 

For  RSX-11M  systems,  if  your  system  does  not  support  the  Extend  Task 
Directive,  then  run  the  I/O  Exerciser  with  an  increment  large  enough 
to  accommodate  all  buffers.  Assuming  all  initial  IOX  defaults, 
allocate  600.  words  per  device  to  be  tested  simultaneously.  For 
example,  to  test  four  devices  simultaneously,  invoke  IOX  as  follows: 

>RUN  $IOX/INC=2400 . 

When  you  invoke  an  uninstalled  version  of  IOX  on  RSX-11M  systems  that 
support  the  Extend  Task  Directive,  you  do  not  need  to  run  the  task 
with  an  increment. 

When  you  invoke  an  uninstalled  version  of  IOX  on  RSX-11M-PLUS  systems, 
you  do  not  need  to  run  the  task  with  an  increment. 
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4.3  USING  INDIRECT  COMMAND  FILES  WITH  IOX 


You  can  use  indirect  command  files  as  input  to  IOX.  IOX  accepts  one 
level  of  indirect  command  files.  You  can  use  indirect  command  files 
to  set  up  your  test  configuration,  choose  devices  for  testing,  set 
exercise  parameters,  and  start  and  exit  the  exercise.  You  cannot 
interrupt  an  I/O  exercise  to  enter  IOX  commands  from  an  indirect 
command  file.  The  default  file  type  is  "CMD." 

For  example,  use  an  editor  to  create  a  file  named  TEST. CMD  that 
contains  the  following  IOX  command  sequence: 


CONFIGURE  DB2 : 


Adds  DB2:  to  the  test  configuration. 


FILES11  DB2 : 


Chooses  DB2 :  for  an  exercise  that  preserves 
the  contents  and  structure  of  the  disk. 


RUNTIME  10 


Sets  an  exercise  parameter  that  runs 
for  10  minutes. 


START 


Starts  the  exercise. 


EXIT 


Exits  from  IOX  to  the  operating  system 
monitor  when  the  exercise  completes. 


After  you  invoke  IOX,  type: 


IOX>  @TEST 


IOX  exercises  DB2 :  (preserving  its  contents  and  structure)  for  10 
minutes  and  then  exits  to  the  operating  system  monitor. 


4.4  SETTING  UP  YOUR  TEST  CONFIGURATION 

Before  you  can  exercise  a  unit,  you  must  first  include  it  in  your  test 
configuration.  When  you  include  a  unit  in  your  test  configuration, 
IOX  adds  the  unit  to  its  list  of  units  available  for  exercising  and 
creates  an  empty  data  structure  for  the  unit.  IOX  includes  in  the 
default  test  configuration  one  of  each  device  type  supported  by 
DIGITAL  as  unit  "0". 

To  add  units  to  the  test  configuration,  you  use  the  CONFIGURE  command. 
The  syntax  for  this  command  is 

CONFIGURE  [ddnn: [=type] 1  .... 


where 

dd 


nn 


Device  mnemonic 


Device  number 


type 

Device  type.  Either  DISK  or  TAPE. 

You  can  add  any  unit  to  the  test  configuration  and  assign  a  logical 
device  name  to  it  by  using  the  MCR  ASN  (ASSIGN)  command. 
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The  CONFIGURE  command  with  no  arguments  displays  the  current  test 
configuration.  For  example: 


I OX> CONFIGURE 
Disks : 

DBO  DDO  DFO  DKO  DLO  DM0  DPO 
DXO  DYO  EMO  SYO 


DRO  DSO  DUO 


Tapes : 

CTO  DTO  MFO  MMO  MSO  MTO 
To  add  DK1 :  and  MM1 :  to  your  configuration,  type: 

I OX> CONFIGURE  DK1 :  MM1 : 

This  command  line  adds  DK1 :  to  the  configuration  as  a  disk  unit 
(because  DKO:  is  already  configured  as  a  disk)  and  MM1 :  to  the 

configuration  as  a  tape  unit  (because  MMO:  is  already  configured  as  a 
tape).  Section  4.12  describes  the  CONFIGURE  command  in  detail. 
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SELECTING  DEVICES  FOR  EXERCISING 


After  having  configured  all  the  units  you  want  to  exercise,  you  select 
units  for  exercising.  When  you  select  a  unit,  IOX  fills  in  the  data 
structure  created  when  you  configured  the  unit.  This  data  structure 
contains  all  the  information  IOX  needs  to  exercise  the  specified  unit. 
You  select  units  for  exercising  with  the  FILES11,  SELECT,  and  VERIFY 
commands.  These  commands  require  device  and  unit  specifications 
within  their  command  lines. 


4.5.1  The  FILES11  Command 

The  FILES! 1  command  selects  a  disk  unit  with  a  mounted  Files-11  volume 
for  an  I/O  exercise.  Exercising  with  FILES11  does  not  affect  the 
contents  of  the  disk  being  tested. 


4.5.2  The  SELECT  Command 

The  SELECT  command  selects  a  unit  with  an  NFS  volume  for  an  I/O 
exercise.  Exercising  with  SELECT  destroys  the  contents  of  the  volume 
being  exercised. 


4.5.3  The  VERIFY  Command 

The  VERIFY  command  selects  a  disk  unit  with  a  mounted  NFS  volume  for 
an  I/O  exercise.  VERIFY  does  not  write  on  the  volume  being  exercised. 
Exercising  with  VERIFY  does  not  affect  the  contents  of  the  volume 
being  exercised  because  VERIFY  only  reads  from  the  volume. 
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4.6  EXERCISE  PARAMETERS 


You  set  parameters  that  determine  how  IOX  exercises  units.  These 
exercise  parameters  determine  aspects  of  testing  such  as  how  long  an 
exercise  is  to  run,  how  many  records  are  tested  on  magnetic  tapes, 
what  range  of  blocks  are  tested  on  disks,  and  whether  output  is 
directed  to  your  terminal  or  to  a  log  file.  There  are  two  kinds  of 
exercise  parameters:  general  and  device  dependent. 


4.6.1  General  Exercise  Parameters 

The  following  commands  set  general  exercise  parameters  and  therefore 
affect  all  IOX  testing: 


CONFIGURE 

CONTROL_C 

LOGFILE 

PATTERN 

REPORTERRORS 

RUNTIME 

SUMMARYTIME 


4.6.2  Device-Dependent  Exercise  Parameters 

You  use  the  commands  listed  in  this  section  to  set  default  parameters 
for  the  units  that  you  select  for  exercising.  You  can  include  these 
commands  within  the  FILES11,  SELECT,  and  VERIFY  command  lines  to 
override  the  default  parameter  for  the  specified  unit. 


4. 6. 2.1  Parameter  Commands  for  Files-11  Disks  with  FILES11  -  The 
following  commands  affect  the  exercising  of  disks  that  you  select  with 
the  FILES11  command: 


COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

TEMPORARYFILE 


You  can  use  these  commands  to  set  the  default 
use  the  FILES11  command  to  select  a  unit, 
commands  within  the  FILES11  command  line  to 
parameters  for  the  unit  being  selected. 


parameters  before  you 
You  can  also  use  these 
override  the  default 


4.6. 2. 2  Parameter  Commands  for  NFS  Volumes  with  SELECT  -  The 
following  commands  affect  the  exercising  of  NFS  volumes  that  you 
select  with  the  SELECT  command: 


BADBLOCKS 

BUFFERSIZE 

COMPAREDATA 

DENSITY 

ERRORLIMIT 

INTERLEAVE 


RANDOM 

RANGE 

RECORDS 

RETRIES 

VOLUMECHECK 

WRITECHECK 
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You  use  these  commands  with  the  SELECT  command  to  set  default 
parameters  for  exercising  a  unit  with  an  NFS  volume.  You  can  use  all 
but  BADBLOCKS  within  the  SELECT  command  line  to  override  the  current 
default  settings  for  the  device  being  selected. 

Table  4-2  shows  the  parameters  for  exercising  different  types  of 
devices. 


Table  4-2 

Parameter  Commands  by  Device  Type  for  SELECT 


NFS  Disks 

Cassettes 

DECtapes 

Magnetic 

Tapes 

BADBLOCKS1 

BUFFERSIZE 

COMPAREDATA 

BUFFERSIZE 

BUFFERSIZE 

COMPAREDATA 

ERRORLIMIT 

ERRORLIMIT 

COMPAREDATA 

ERRORLIMIT 

DENSITY 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

RECORDS 

RECORDS 

RETRIES 

1.  Cannot  be  used  within  SELECT  command  line. 


4.6. 2. 3  Parameter  Commands  for  NFS  Volumes  with  VERIFY  -  The 
following  commands  affect  the  exercising  of  NFS  disks  that  you  select 
with  the  VERIFY  command: 

BADBLOCKS 

BUFFERSIZE 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

You  use  these  commands  with  the  VERIFY  command  to  set  default 
parameters  for  testing  a  unit  with  an  NFS  disk.  You  can  use  all  but 
BADBLOCKS  within  the  VERIFY  command  line. 


4.7  SETTING  PARAMETERS  FOR  EXERCISING  FILES11  VOLUMES 

This  section  shows  you  how  to  use  IOX  to  exercise  an  RL02  with  a 
Files-11  structure.  Example  4-1  uses  the  following  IOX  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  IOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 
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RUNTIME 

Sets  the  length  of  time  (in  minutes)  that  IOX  exercises  the 
unit(s)  you  have  selected  for  testing. 

FILES11 

Selects  a  disk  with  a  mounted  Files-11  volume  for  an  I/O  exercise 
that  preserves  the  contents  and  structure  of  the  disk. 

TEMPORARYFILE 

Sets  the  size  of  the  temporary  file  that  IOX  uses  for  testing 
Files-11  disks  with  the  FILES11  command. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 


Example  4-1  Exercising  an  RL02  with  the  FILES11  Command 


> ALL  DLO ♦ 

>M0U  DLO l  LOUIE 
>IOX 


o 

0 

© 


1 0X>  PARAMETER!.  1ST 
BUFFERSIZE=  1024. 
ERRORLIMIT®  10. 
INTERLEAVE®  4. 
PATTERN31  0. 

RECORDS®  1024. 
RUNTIME®  5. 
SUMMARYTIME®  1, 
TEMPORARYFILE®  500. 


C0MPAREDATA®  YES 
CONTROL-C®  YES 
LOGFILE®  NO 
RANDOM®  YES 
REPORTERRORS®  YES 
0  RETRIES®  YES 

VOLUMECHECK®  YES 
©  WAIT®  YES 

WRITECHECK®  NO 


Buffer  space  useae®  3290.51924,51924.51. 


IOX>RUNTIME  3 
I0X>FILES11  DLO  5  TEMP  =  800 
IOX>PARAMETER 


0 

0 


"\ 


J 


Device  Mode  Buffersize  Filesize/Records/Ranse  Parameters 

DL05  FI 1  512.  800.  ©  COM  RET  RAN  ERR=10 


) 


BUFFERSIZE*  1024* 
ERRORLIMIT*  10* 
INTERLEAVE*  4* 
PATTERN*  0* 
RECORDS*  1024 ♦ 
RUNTIME*  3, 
SUMMARYTIME*  1* 
TEMP0RARYFILE=500« 


COMPAREDATA*  YES 
CONTROL-C*  YES 
LOGFILE*  NO 
RANDOM*  YES 
REPORTERRORS*  YES 
Q  RETRIES*  YES 

VOLUMECHECK*  YES 
©  WAIT*  YES 

WRITECHECK*  NO 


Buffer  space  usage*  3290 *:  1 308 *  1 1 308 *: 1  * 


I0X>ST  ART 


© 
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The  command  sequence  in  Example  4-1  does  the  following: 

Q  Allocates  drive  DLO : • 

0  Mounts  the  disk  with  label  "LOUIE"  in  DLO:. 

0  Invokes  an  installed  version  of  IOX  with  default  task  name, 
. . .IOX. 

0  Displays  the  initial  default  parameters  with  PARAMETERLIST. 

0  Changes  the  default  RUNTIME  to  three  minutes. 

0  Selects  DLO:  for  FILES11  testing  with  a  temporary  file  size 
of  800  blocks. 

Note  the  difference  between  the  defaults  displayed  by  the 

PARAMETERLIST  command  before  and  after  you  changed  RUNTIME  and  sleeted 
DLO:  . 

0  Only  the  RUNTIME  default  has  changed. 

0  The  default  for  TEMPORARYFILE  has  not  changed. 

0  After  you  selected  DLO:  for  testing,  PARAMETERLIST  contains 
an  extra  line  at  the  beginning  that  displays  all 
device-dependent  parameters  for  the  selected  device.  Each 
selected  device  has  its  own  display  line.  There  are  five 
fields  of  parameters. 

0  Field  four  shows  that  the  temporary  file  size  used  for 

FILES11  testing  for  DLO:  is  800.  blocks  instead  of  the 

500. -block  initial  default.  During  FILES11  testing,  this 
field  refers  only  to  temporary  file  size. 

0  The  START  command  begins  FILES11  testing  on  DLO:  for  a 

RUNTIME  of  three  minutes  and  uses  a  temporary  file  size  of 
800.  blocks. 


4.8  SETTING  PARAMETERS  FOR  EXERCISING  NFS  VOLUMES 

This  section  shows  examples  for  the  command  sequences  that  test  a 
magnetic  tape  with  SELECT  and  an  NFS  disk  with  VERIFY.  Both  examples 
are  explained  in  detail. 


4.8.1  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 

The  command  sequence  in  Example  4-2  tests  a  magnetic  tape  by  using  a 
buffer  of  8K  bytes,  which  contains  the  data  pattern  052652,  to 
transfer  data. 

Example  4-2  illustrates  the  following  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  IOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 
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PATTERN 

Sets  the  pattern  that  IOX  writes  and  reads  during  an  exercise. 
BUFFERSIZE 

Sets  the  amount  of  data  that  IOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes. 

DENSITY 

Sets  the  density  and  characteristic  word  of  the  specified 
magnetic  tape  or  displays  the  current  density  and  characteristic 
word  for  the  specified  magnetic  tape  unit. 

SELECT 

Selects  a  unit  with  a  mounted  NFS  scratch  volume  for  an  I/O 
exercise  that  destroys  the  contents  of  the  volume 

RETRIES 

Determines  (for  magnetic  tapes  and  NFS  disks)  whether  an  I/O 
driver  repeats  an  I/O  operation  after  the  driver  receives  errors 
during  the  operation. 

ERRORLIMIT 

Sets  the  maximum  number  of  errors  that  IOX  tolerates  between 
interval  reports  before  terminating  testing  on  a  device. 

RECORDS 

Specifies  the  number  of  records  to  be  exercised  on  magnetic  tapes 
and  cassettes. 


START 


Starts  exercising  units  that  you  have  selected  for  testing. 

EXIT 


Terminates  IOX  processing  and  exits  from  IOX. 


Example  4-2  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


> ALL  MMO ♦ 

>MOU  mmo: 

>IOX 

IQX>PARAMETERLIST 

}• 

BUFFERSIZE*  1024* 

© 

C0MPAREDATA*  YES 

ERRORLIMIT*  10. 

CONTROLS*  YES 

INTERLEAVE*  4. 

L0GFILE*  NO 

PATTERN*  0. 

© 

RANDOM*  YES 

RECORDS*  1024. 

REPORTERRORS*  YES 

RUNTIME*  5. 

RETRIES*  YES 

SUMMARYTIME*  1. 

VOLUMECHECK*  YES 

TEMPORARYFILE*  500. 

WAIT*  YES 
WRITECHECK*  NO 

Buffer  space  usage* 

3290. { 

1924. : 1924. : 1 . 

(continued  on  next  page) 
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Example  4-2  (Cont.)  Exercising  a  Magnetic  Tape  with  the  SELECT  Command 


IOX>PATTERN  12  © 

IOX>BUFFER  8192  O 

1'0X>DENS  MMO: 

Density*  1600  DPI  Characteristic  Word*  004004  (octal) 
IOX>SELECT  MHO?  RETRIES=NO  DENSITY=800  ERR0R=100  REC=20000 
I0X>PARAM 


Device  Mode  Buffersise  Fi lesize/Records/Rande  Parameters 


MMO:  NFS  8192 ♦  ©  20000  *  ©  COM  E  R  R 33 1 0  ♦  © 

BUFFERSIZE33  8192* 

ERRORLIMIT=  10* 

INTERLEAVE33  4* 

PATTERN33  1 2 ♦ 

RECORDS33  1024 * 

RUNTIME33  5  ♦ 

SUMMARYTIME33  1* 

TEMPORARYFILE*  500. 


Buffer  space  usade*  36058 . 1 8188 . 1 18292 . t 3  * 

IOX>DENSITY  MMO: 

Density*  800  BPI  Characteristic  Word*  000000  (octal)  J 

I0X>START  © 

IOX  —  MMO ♦  b 3d  block ?  112  (decimal)  160  (octal) 


©  COMPAREDAT  A33  YES 

C0NTR0L-.C33  YES 
L0GFILE=  NO 
©  RANDOM38  YES 

REP0RTERR0RS33  YES 
RETRIES53  YES 
VQLUMECHECK33  YES 
WAIT55  YES 
WR ITECHECK35  NO 


IOX  --  Summary  of  exerciser  activity  at  20-JUL-S1  16*50*40 
TIME  —  Run*  1  min*  Elapsed:  1  min*  Remaining*  4  min* 

MMO*  --  230*  R/W  reauests  totaling  230*  records  with  1  errors 
AST's  executed*  346* 

Idle-loop  iterations*  344* 


IOX  --  MMO:  bad  block?  486  (decimal)  746  (octal) 

IOX  --  MMO  *  bad  block?  551  (decimal)  1047  (octal) 

IOX  --  Summary  of  exerciser  activity  at  20-JUL-81  16554550 
TIME  --  Run:  1  min*  Elapsed:  5  min*  Remaining:  0  min* 

MMO**  —  217*  R/W  requests  totaling  217*  records  with  2  errors 
AST's  executed:  325* 

Idle-loop  iterations:  321* 

ACCUMULATED  TOTALS** 


TIME  —  Run:  5  mir»*  Elapsed:  5  min*  Remaining:  0  min* 

MMO!  —  1 ? 121 ♦  R/W  reauests  totaling  1?121*  records  with  3  errors 
AST's  executed:  1?636* 

Idle-loop  iterations:  1?670* 

IQX>EX I T 
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The  command  sequence  in  Example  4-2  does  the  following: 

O  Allocates  drive  MMO:,  mounts  the  magnetic  tape,  and  invokes 
an  installed  version  of  IOX. 

On  RSX11M-PLUS  systems,  you  mount  the  tape  wiht  the  /FOREIGN 
switch. 

©  Displays  the  initial  defaults. 

©  Selects  pattern  number  12  to  be  written  to  the  tape. 

©  Changes  the  default  BUFFERSIZE  from  1024.  to  8192.  (8K)  . 

©  Displays  the  default  density  and  characteristic  word  on  the 
magnetic  tape  mounted  in  drive  MMO:. 

©  Selects  MMO:  for  NFS  testing  with  SELECT,  overriding  the 
defaults  for  RETRIES,  ERRORLIMIT  and  RECORDS,  and  sets  the 
tape  density  at  800. 

©  Checks  the  parameters  with  PARAMETERLIST  and  DENSITY. 

©  Changes  the  BUFFERSIZE  default. 

©  Changes  the  PATTERN  default. 

©  Displays  the  device  display  line  for  MMO:. 

©  Shows  the  current  BUFFERSIZE  of  MMO:. 

©  Shows  that  the  number  or  records  to  be  tested  is  20000. 

©  Starts  NFS  testing  with  SELECT  on  MMO:. 

The  remainder  of  Example  4-2  shows  interval  reports,  error  reports, 
and  an  accumulated  totals  generated  at  your  terminal  during  this 
exercise.  These  reports  are  discussed  fully  in  Section  4.10.  When 
the  exercise  has  finished,  you  exit  to  the  operating  system  monitor 
unless  you  want  to  do  more  testing. 


4.8.2  Exercising  with  the  VERIFY  Command 

The  command  sequence  in  Example  4-3  performs  oscillating  seeks  between 
blocks  1  and  1000  to  align  disk  heads.  It  reads  only  four  bytes  per 
data  transfer ,  which  is  the  minimum.  No  error  or  summary  reporting  is 
required.  The  exercise  runs  until  you  abort  it. 

Example  4-3  illustrates  the  following  commands: 

PARAMETERLIST 

Displays  current  default  parameters,  IOX  buffer  space  statistics, 
and  device-dependent  parameters  for  devices  you  have  selected  for 
testing . 

VERIFY 

Selects  a  mounted  disk  for  an  NFS  exercise  that  reads  buffers  of 
data  without  writing  on  the  disk,  performing  data  comparisons,  or 
destroying  the  contents  of  the  disk. 
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RANGE 


Sets  the  minimum  and  maximum  block  numbers  for  NFS  testing  on  the 
specified  disk. 

BUFFERSIZE 

Sets  the  amount  of  data  that  IOX  transfers  for  every  read  or 
write  request  when  testing  NFS  disks,  magnetic  tapes,  and 
cassettes . 

RANDOM 

Directs  IOX  to  select  either  random  or  sequential  blocks  for  disk 
testing . 

INTERLEAVE 

Sets  the  number  of  blocks  to  be  skipped  before  IOX  writes  the 
next  buffer  of  data  for  disk  testing  (applies  only  to  sequential 
testing  which  you  determine  with  the  RANDOM  command) . 

ERRORLIMIT 

Sets  the  maximum  number  of  errors  that  IOX  tolerates  between 
interval  reports  before  terminating  testing  on  a  device. 

REPORTERRORS 

Enables  or  disables  error  reports. 

SUMMARYTIME 

Determines  how  often  (in  minutes)  IOX  will  output  interval 
reports . 

RUNTIME 

Sets  the  length  of  time  (in  minutes)  that  IOX  exercises  the 
unit(s)  you  have  selected  for  testing. 

LOGFILE 

Determines  whether  IOX  directs  activity  and  error  reports  to  your 
terminal  or  to  a  log  file. 

START 


Starts  exercising  units  that  you  have  selected  for  testing. 

CTRL/C 

With  CONTROL_C  enabled,  allows  you  to  enter  IOX  commands  while  an 
exercise  is  in  progress. 

ABORT 

Terminates  execution  of  an  I/O  exercise. 
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Example  4-3  Exercising  an  NFS  RK07  with  the  VERIFY  Command 


>ALL  DM0  5 
>M0U  DMO  J 
>I0X 
I0X>F'AR 

BUFFERSIZE=  1024. 
ERRORLIMIT=  10. 
INTERLEAVE*  4. 
PATTERN=  0. 

REC0RDS=  1024. 
RUNTIME*  5. 
SUMMARYTIME*  1. 
TEMPORARYFILE*  500. 


COMPAREDATA*  YES 
CONTRQL-C*  YES 
LOGFILE*  NO 
RANDOM*  YES 
REPORTERRORS*  YES 
RETRIES*  YES 
VOLUMECHECK*  YES 
WAIT*  YES 
WRITECHECK*  NO 


Buffer  space  usage*  3290. 51924. 11924. 51, 


•\ 


J 


IOX>VERIFY  DM05  RANGE*151000  BUF=4  RAND=N  INTER=999  ERR=50000  3 
IOX>REPORTERRORS  NO  ^  W 

IOX>SUMMARY  0 
IOX>RUNTIME  0 
I0X>L06  Y 
IOX>PAR 

Device  Mode  Buffersize  Fi  lesize/Records/RanSe  Parameters 


■\ 


DM01 


VFY 


4. 


BUFFERSIZE*  1024. 
ERRORLIMIT*  10. 
INTERLEAVE*  4. 
PATTERN*  0. 

RECORDS*  1024. 
RUNTIME*  0. 
SUMMARYTIME*  0. 
TEMPORARYFILE*  500. 


1.  ->  1»000. 

COMPAREDATA*  YES 
CONTROL_C=  YES 
LOGFILE*  YES 
RANDOM*  YES 
REPORTERRORS*  NO 
RETRIES*  YES 
VOLUMECHECK*  YES 
WAIT*  YES 
WRITECHECK*  NO 


RET  INT=999. ERR =50000. 


Buffer  space  usage*  3290.11912.51912.51, 


IOX>ST 
IOX>"C 
IOX>ABORT 

The  command  sequence  in  Example  4-3  does  the  following: 


J 


O  Allocates  drive  DMO:,  mounts  the  RK07  for  NFS  testing,  and 
invokes  IOX. 


On  RSX1 1M-PLUS  systems,  mount  disks  with  the  /FOREIGN 
switch. 


©  Displays  the  initial  default  parameter. 

©  Selects  DMO:  for  read-only  NFS  testing  with  VERIFY, 

overriding  the  following  defaults: 

a.  RANGE  —  blocks  1  through  1000 

b.  BUFFERSIZE  —  minimum,  four  bytes 

c.  RANDOM  block  testing  turned  off  and  INTERLEAVE  set  at 
999  so  that  IOX  tests  only  blocks  1  and  1000 
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d.  ERRORLIMIT  set  impossibly  high  (50000.)  so  that  IOX  will 
not  deselect  DM0:  no  matter  how  many  errors  are 

encountered  during  the  exercise 

Q  Turns  off  REPORTERRORS  so  that  no  error  reports  are 
generated.  Turns  SUMMARYTIME  off  so  that  no  interval 
reports  will  be  generated.  Sets  RUNTIME  to  zero  so  that  IOX 
runs  the  exercise  until  you  abort  it.  Sets  LOGFILE  YES  to 
direct  all  output  to  the  log  file,  IOX. LOG,  instead  of  to 
the  terminal. 

0  Shows  that  the  RUNTIME,  SUMMARYTIME,  and  LOGFILE  defaults 
have  been  reset  and  that  DM0:  is  being  tested  with  VERIFY, 
using  a  buffersize  of  4.,  over  a  range  of  1000.  blocks, 
with  RETRIES  enabled,  INTERLEAVE  set  at  999,  and  ERRORLIMIT 
set  at  50000. 

0  Shows  how  to  start  the  exercise  using  the  START  command  and 
enter  Interactive  Mode  with  CTRL/C  so  you  can  enter  the 
ABORT  command  to  abort  the  exercise. 

Example  4-4  shows  the  contents  of  the  log  file  for  Example  4-3. 


Example  4-4  Log  File  Output  for  Example  4-3 


IOX  —  20-JUL-81  18:24:12  ********  EXERCISER  STARTED  ******** 
Device  Mode  Buffersize  Fi  lesize/Records/RanSe  Parameters 


DM05 


VFY 


BUFFERSIZE=  1024. 
ERRORLIMIT=  10. 
INTERLEAVE3  4. 
PATTERN3  0. 

RECORDS3  1024. 
RUNTIME3  0. 
SUMMARYTIME3  0. 
TEMPORARYFILE3  500, 


1.  ->  1 > 000 . 

C0MPAREDATA3  YES 
C0NTR0L..C3  YES 
LOGFILE3  YES 
RANDOM3  YES 
REPORTERRORS3  NO 
RETRIES3  YES. 
V0LUMECHECK3  YES 
WAIT3  YES 
WRITECHECK3  NO 


RET  I NT=999 .  ERR=50000. 


Buffer  space  usage3  3290.51812.51812.51. 


IOX  —  Summary  of  exerciser  activity  at  20-JUL-81  18527528 

TIME  —  Run5  3  min.  Elapsed:  3  min.  Remaining?  65533  min. 

DM05  —  3 , 075 .  R/W  reouests  totaling  3»075.  blocks  with  no  errors 
AST's  executed}  3*081. 

Idle-loop  iterations!  2 » 982 . 


ACCUMULATED  TOTALS: 


TIME  --  Run5  0  min.  Elapsed:  3  min.  Remaining:  65533  min. 

DM0  5  A  —  3 1 076 .  R/W  requests  totaling  3>076.  blocks  with  no  errors 
AST's  executed!  3»082. 

Idle-loop  iterations:  2>982. 

IOX  —  20-JUL-81  18527531  ********  EXERCISER  ABORTED  ******** 


The  log  file  output  terminates  when  you  abort  the  Exerciser.  The  log 
file  begins  with  the  time  and  date  that  the  exercise  began  and  the 
current  default  parameters  as  displayed  by  the  PARAMETERLIST  command. 
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4.9  IOX  OPERATING  MODES 

IOX  operates  in  three  modes:  Command,  Execution,  and  Interactive. 
This  section  discusses  the  functions  of  these  modes,  how  you  enter  and 
exit  each  mode,  and  what  IOX  commands  are  valid  in  each  mode. 


4.9.1  Command  Mode 

IOX  is  in  Command  Mode  after  you  have  invoked  it  and  have  received  the 
first  IOX  prompt.  (Section  4.2  discusses  IOX  prompts.)  In  Command 
Mode,  no  devices  are  being  exercised,  and  tasks  initiated  by  the 
EXECUTE  command  are  queued  but  not  active  (see  Section  4.12  for  a 
complete  description  of  the  EXECUTE  command.)  You  usually  set 
parameters,  select  devices  for  testing,  and  initiate  tasks  to  be 
executed  in  Command  Mode. 

When  you  press  the  RETURN  key,  you  receive  an  IOX  prompt.  When  you 
press  CTRL/C,  you  exit  to  MCR  for  one  command  line. 


4.9.2  Execution  Mode 

When  you  begin  an  I/O  exercise  by  entering  the  START  command,  IOX 
exits  Command  Mode  and  enters  Execution  Mode.  Exercises  begin  on 
selected  devices,  tasks  initiated  with  the  EXECUTE  command  begin 
executing,  the  IOX  clock  is  turned  on,  and  activity  and  error 
reporting  begin. 

You  set  the  CONTROL _ C  parameter  in  Command  Mode  to  allow  or  disallow 

you  to  enter  IOX  commands  while  an  exercise  is  in  progress.  CONTROL  C 
YES  is  the  initial  default  setting.  “ 

If  you  have  set  CONTROL_C  NO,  then  CTRL/C  in  Execution  Mode  gives 
control  to  MCR  and  you  receive  the  MCR  prompt  ">"  every  time  you  press 
the  RETURN  key  and  ,,MCR>"  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot  interrupt 
the  exercise.  However,  you  can  terminate  it  with  the  MCR  ABORT 
command . 

If  you  have  set  CONTROL__C  YES,  IOX  does  not  accept  any  input  from  your 
terminal  except  CTRL/C.  If  you  try  to  enter  anything  but  CTRL/C,  you 
receive  an  error  message  for  each  key  you  press: 

IOX  —  Only  ~C  Allowed 

When  you  press  CTRL/C,  you  receive  the  IOX  prompt  instead  of  the  MCR 
prompt  and  IOX  exits  Execution  Mode  and  enters  Interactive  Mode. 


4.9.3  Interactive  Mode 

You  have  access  to  Interactive  Mode  only  if  CONTROL_C  is  enabled. 
When  you  press  CTRL/C  in  Execution  Mode,  IOX  exits  Execution  Mode  and 
enters  Interactive  Mode.  In  Interactive  Mode,  the  RETURN  key  and 
CTRL/C  have  the  same  functions  that  they  have  in  Command  Mode. 

In  Interactive  Mode,  the  exercise  and  tasks  initiated  by  the  EXECUTE 
command  are  running.  Activity  reports  and  error  reports  directed  to 
your  terminal  are  suspended  if  you  have  set  LOGFILE=NO.  If  you  have 
set  L0GFILE=YES ,  activity  and  error  reports  continue  as  in  Execution 
Mode . 
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All  IOX  commands  except  the  following  are  valid  in  Interactive  Mode: 

BUFFERSIZE 

PATTERN 

RUNTIME 

START 

RESTART 

If  you  enter  these  commands,  IOX  prints  the  error  message: 

IOX  —  Command  valid  only  in  command  mode 

You  can  use  the  -  BUFFERSIZE  command  within  the  SELECT  and  VERIFY 
command  lines  to  override  the  current  defaults  for  the  device  being 
selected,  but  the  BUFFERSIZE  command  cannot  be  used  by  itself  to  reset 
the  default. 

Although  you  cannot  use  the  PATTERN  command  to  choose  a  different 
pattern  to  be  written  to  the  volumes  being  tested,  you  can  use  PATTERN 
with  no  argument  to  display  all  the  patterns. 

The  following  commands  are  valid  only  in  Interactive  Mode: 

ABORT 

PRINTSUMMARY 

PROCEED 

SPY 

Although  you  can  issue  PRINTSUMMARY  and  SPY  in  Command  Mode  without 
generating  an  error  message,  these  commands  display  meaningful 
information  only  when  you  issue  them  in  Interactive  Mode. 

When  you  issue  the  ABORT  command,  IOX  exits  Interactive  Mode  and 
enters  Command  Mode.  The  ABORT  command  with  no  qualifiers  terminates 
all  exercising  and  all  tasks  initiated  by  the  EXECUTE  command.  This 
form  of  ABORT  is  valid  only  in  Interactive  Mode  because  in  Command 
Mode  there  can  be  no  exercise  or  active  tasks  to  abort. 

The  PROCEED  command  exits  Interactive  Mode  and  enters  Execution  Mode 
unless  no  activity  remains  when  you  issue  PROCEED,  in  which  case  IOX 
aborts  the  exercise. 


4.10  IOX  OUTPUT 

IOX  generates  two  types  of  output:  activity  reports  and  error 
reports.  Activity  reports  summarize  IOX  processing  information,  such 
as  how  long  an  exercise  will  run  and  how  many  ASTs  have  been  executed. 
There  are  two  kinds  of  error  reports:  data  compare  error  reports, 
that  show  where  IOX  finds  errors  on  the  volume  being  tested,  and  I/O 
error  reports,  that  indicate  failed  QIOs  from  a  driver.  You  use  the 
LOGFILE  command  (see  detail  in  Section  4.12)  to  direct  activity  and 
error  reports  to  your  terminal  or  to  a  log  file. 


4.10.1  Activity  Reports 

There  are  three  types  of  activity  reports: 


Accumulated  Totals 


An  activity  report  at  the  end  of  an  IOX  exercise  that 
activity  for  the  entire  exercise 


reports  the 
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Interval  Reports 

An  activity  report  that  summarizes  IOX  activity  in  the  time 
intervals  set  by  the  SUMMARYTIME  command 

Summary  Reports 

A  report  of  activity  between  the  last  Interval  Report  and  the 
time  you  enter  the  PRINTSUMMARY  command  to  request  a  summary 
report. 

Section  4.12  discusses  the  SUMMARYTIME  and  PRINTSUMMARY  commands  in 
detail . 


4.10.1.1  The  Format  of  Activity  Reports  -  The  formats  of  activity 
reports  are  indentical  except  for  the  first  line.  Interval  and 
summary  reports  begin  with  the  time  and  date  of  the  report.  For 
example : 

IOX  —  Summary  of  exerciser  activity  at  20-JUL-81  11:16:26 

The  accumulated  totals  report  does  not  give  the  time  or  date  of  the 
report  and  begins: 

ACCUMULATED  TOTALS: 


4.10.1.2  The  Content  of  Activity  Reports  -  The  content  of  all 
activity  reports  is  identical.  The  following  is  an  interval  report  of 
an  exercise  that  tests  SYO:. 

IOX  —  Summary  of  exerciser  activity  at  31-DEC-80  11:18:29 
TIME  —  Run:  1  min.  Elapsed:  2  min.  Remaining:  3  min. 

SYO:  lf874.  R/W  requests  totaling  1,874.  blocks  with  no  errors 

ASTs  executed:  1,875. 

Idle-loop  iterations:  1,803. 

The  activity  report  contains  the  following  information: 

•  Timing  information 

-  Time  between  reports  as  set  in  the  SUMMARYTIME  command 

-  Time  that  the  exercise  has  been  in  progress  to  the  nearest 
minute 

-  Time  remaining  to  the  nearest  minute  before  the  exercise 
will  finish 

•  Unit  information  for  each  unit  being  tested 

-  Number  of  I/O  requests  to  the  unit 

-  Number  of  block  exercises  on  the  unit 

-  Number  of  error  encounters  on  the  unit 

•  Number  of  ASTs  executed 

•  Number  of  iterations  through  the  idle  loop 
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You  use  the  following  commands  to  control  the  output  of  activity 
reports : 

LOGFILE 

PRINTSUMMARY 

SPY 

SUMMARYTIME 

Section  4.12  discusses  each  of  these  commands  in  detail. 


4.10.2  Error  Reports 

You  use  the  REPORTERRORS  command  to  enable  or  disable  error  reports. 
Section  4.12  discusses  the  REPORTERRORS  command  in  detail.  There  are 
two  kinds  of  error  reports:  data  compare  error  reports  and  I/O  error. 


4.10.2.1  Data  Compare  Error  Reports  -  A  data  compare  error  means  that 
the  driver  returned  a  success  I/O  code  to  IOX  but  that  the  data 
written  to  the  volume  and  the  data  read  from  the  volume  did  not  match. 
The  following  is  an  error  report  generated  by  a  data  compare  error: 

IOX  —  DR1 :  data  compare  error  at  block  33,931  (decimal)  102221  (octal) 
Good  Data:  005767  Bad  Data:  155555  ©  0 

Word  Position:  0  (decimal)  0  (octal)  0 
Buffer  contained  255.  additional  errors  0 

0  Identifies  the  device  on  which  IOX  encountered  an  error. 
It  reports  the  starting  block  (in  both  decimal  and  octal) 
in  which  the  error  was  found. 

0  Shows  the  "good  data"  that  IOX  wrote  to  the  volume  and  the 
"bad  data"  that  IOX  read  from  the  volume.  Only  the  first 
error  encountered  in  the  test  buffer  is  reported. 

0  Shows  the  position  of  the  first  word  in  the  test  buffer 
that  generated  a  mismatch  during  the  current  operation. 
Only  the  first  error  encountered  in  the  test  buffer  is 
reported . 

0  Shows  how  many  other  errors  were  found  in  the  test  buffer. 


4.10.2.2  I/O  Error  Reports  -  There  are  12  I/O  errors.  If  a  QIO 
fails,  the  driver  returns  an  I/O  failure  code  to  IOX.  IOX  generates  a 
specific  I/O  error  report  as  a  result  of  the  following  I/O  errors: 


I/O  Code 

Description 

IE. ABO 

Operation  aborted 

IE.BBE 

Bad  block 

IE. DAO 

Data  overrun 

IE.DNR 

Device  not  ready 

IE. EOT 

End -of- tape  detected 

IE.FHE 

Fatal  hardware  error 

IE.OFL 

Device  off-line 

IE.PRI 

Privilege  violation 

IE. VER 

Unrecoverable  error 

IE.WCK 

Write  check  error 

IE.WLK 

Write-lock  error 

N/A 

Unexpected  error 
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These  error  codes  are  shown  in  the  RSX11M/M-PLUS  I/O  Drivers  Reference 
Manual .  Section  4.13  of  this  chapter  presents  the  format  and  content 
of  the  12  error  messages  that  IOX  generates  because  of  these  error 
codes . 


4.11  THE  TASK  BUILD  FILE 

You  can  change  the  initial  defaults  for  IOX  parameters  as  well  as 
other  defaults  of  the  IOX.TSK  by  editing  the  IOX  task-build  file. 
IOXBLD.BLD. 

On  RSX-11M  systems,  this  file  is  located  on  your  system  disk  in  UFD 
[1,24]  for  mapped  systems  and  [1,20]  for  unmapped  systems. 

On  RSX-11M-PLUS  systems,  this  file  is  located  on  your  system  disk  in 
UFD  [1,24] . 


4.12  COMMAND  DESCRIPTIONS 

This  section  provides  complete  descriptions  of  the  commands  in  the  IOX 
Command  Language.  Each  command  description  includes: 

•  Kind  of  command  by  category:  Function,  Display,  Parameter, 

and  Control 

•  All  command  formats 

•  Qualifier  descriptions 

•  Operating  mode  restrictions  (where  no  mode  restrictions  are 
placed  on  a  command,  it  is  valid  in  Command  Mode  and 
Interactive  Mode) 

•  Kinds  of  devices  and  testing  to  which  the  command  applies 

•  Initial  defaults  if  applicable 
The  commands  are  presented  alphabetically. 

Commands  may  be  issued  in  all  uppercase,  all  lowercase,  or  part  upper 
and  part  lowercase.  You  can  abbreviate  commands  using  any  combination 
of  characters  that  appear  unique  to  the  IOX  Command  Language. 

All  commands  are  represented  by  unabbreviated  uppercase  letters.  All 
lowercase  words  in  the  presentations  of  command  syntax  indicate  that 
you  substitute  alphanumeric  characters  for  the  word. 

All  numerical  qualifiers  are  decimal. 

Brackets  [  ]  indicate  optional  elements  in  the  command  line. 
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ABORT 


A [ BORT] 


[/ALL] 

[  taskname] 


The  ABORT  command  is  an  IOX  control  command.  You  cannot  use  the  ABORT 
command  to  abort  a  task  that  has  attached  your  terminal ,  such  as  PIP. 


There  are  three  forms  of  ABORT: 


ABORT 


ABORT  /ALL 


Terminates  the  execution  of  an  I/O  exercise  and 
tasks  initiated  by  the  EXECUTE  command.  This  form 
of  ABORT  is  valid  only  in  Interactive  Mode 
(testing  in  progress)  because  in  Command  Mode  (no 
testing  in  progress)  there  can  be  no  running 
exercise  or  active  tasks  to  abort. 

In  Interactive  Mode  this  form  of  ABORT  terminates 
the  execution  of  all  tasks  initiated  by  the 
EXECUTE  command  and  removes  the  tasks  from  the 
list  of  tasks  to  be  executed.  In  Command  Mode, 
this  form  of  ABORT  removes  all  tasks  from  the  list 
of  tasks  to  be  executed. 


ABORT  taskname  In  Interactive  Mode  this  form  of  ABORT  terminates 

the  execution  of  a  task  initiated  by  the  EXECUTE 
command  and  removes  the  task  from  the  list  of 
tasks  to  be  executed.  In  Command  Mode,  this  form 
of  ABORT  removes  the  task  from  the  list  of  tasks 
to  be  executed. 
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BADBLOCKS 


BAfDBLOCKS]  ddnn:  [blocknumber s] 

You  can  use  BADBLOCKS  as  a  device-dependent  parameter  command  or  a 
display  command.  BADBLOCKS  applies  only  to  NFS  disk  testing. 

BADBLOCKS  requires  a  device  specification  "dduu:".  To  use  the 

BADBLOCKS  command,  the  disk  that  you  specify  must  already  be  selected 

for  NFS  operations. 

BADBLOCKS  as  a  Parameter  Command 

With  the  BADBLOCKS  Parameter  Command,  you  can  omit  the  bad  blocks  on 
your  disk  from  IOX  testing.  BADBLOCKS  does  not  find  bad  blocks  on 
your  disk;  it  allows  you  to  enter  those  blocks  that  the  BAD  utility 
has  reported  to  be  bad  into  an  IOX  badblocks  list  for  the  disk.  When 
you  exercise  the  disk  with  SELECT  or  VERIFY,  the  blocks  that  you 
entered  in  the  list  will  not  be  exercised.  IOX  omits  only  those 
blocks  that  you  listed  as  blocknumbers  in  the  BADBLOCKS  command  line; 
blocks  marked  as  bad  by  the  BAD  utility  but  not  entered  into  the 

badblocks  list  with  the  BADBLOCKS  command  are  treated  as  good  blocks 

by  IOX. 

Once  you  have  made  entries  in  the  badblocks  list  for  a  disk,  the  block 
numbers  that  you  entered  remain  on  the  list  until  you  deselect  the 
disk. 

There  are  two  formats  for  entering  bad  blocks  into  the  badblocks  list. 
One  format,  using  DM1:  as  an  example,  is: 

BADBLOCKS  DM1:  3 

This  command  line  enters  block  3  in  the  badblocks  list  for  DM1:. 
Another  example: 

BADBLOCKS  DM1:  3,4,5,11,12,13,99,151 

This  command  line  enters  blocks  3,  4,  5,  11,  12,  13,  99,  and  151  into 
the  badblocks  list  for  DM1:. 

The  second  format  has  the  form: 

beg :num 


beg 


Beginning  block  number 


num 


Number  of  sequential  blocks 
For  example: 

BADBLOCKS  DM1:  3:3,10:4,100:50 

This  command  line  enters  blocks  3  through  5,  10  through  13,  and  100 
through  149  into  the  badblocks  list  for  DM1:.  You  can  use  this  format 
for  the  length  of  a  single  command  line. 


4-24 


THE  I/O  EXERCISER  (IOX) 


BADBLOCKS  (Cont.) 


You  can  use  the  two  formats  together  on  the  same  command  line.  For 
example : 

BADBLOCKS  DM1:  3:3,10:4,99,100:50,151 

This  command  line  enters  blocks  3  through  5,  10  through  13,  99,  100 

through  149,  and  151  into  the  BADBLOCK  list  for  DM1:. 

BADBLOCKS  as  a  Display  Command 

BADBLOCKS  with  no  blocknumbers  specified  is  a  Display  Command.  For 
example : 

BADBLOCKS  DM1: 

This  command  line  displays  the  badblocks  list  for  DM1:.  If  you  had 
typed : 

BADBLOCKS  DM1:  3:5,10:4,99,100:50,151 

IOX  would  display: 

000003:005 

000010:004 

000099:051 

000151:001 

IOX  displays  the  badblocks  list  using  a  variation  of  the  second 
format.  It  strings  consecutive  blocks  together  even  if  you  did  not 
enter  them  using  the  second  format.  For  example,  in  the  command  line 
you  entered: 

99,100:50. . . . 

However,  when  IOX  displays  the  badblocks  list,  it  does  not  separate 
these  because  blocks  99  and  100  are  consecutive  blocks.  It  does  not 
display  two  lines:  one  for  block  99  and  one  for  blocks  100  through 
149.  Instead,  it  displays  (line  three)  the  badblocks  list  in  one  line 
as  if  you  had  entered  51  blocks  (99:51)  beginning  with  block  99  in  the 
badblocks  list. 
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BUFFERSIZE 


BU [ FFERSIZE]  buffer size 

BUFFERSIZE  is  a  device-dependent  parameter  command.  You  use 
BUFFERSIZE  to  determine  the  amount  of  data  that  IOX  transfers  for 
every  read/write  request  when  exercising  NFS  disks,  magnetic  tapes, 
and  cassettes.  IOX  stores  the  specified  size  in  bytes  and  rounds  this 
number  up  to  the  next  four-byte  boundary. 

When  you  use  the  random  data  pattern  (PATTERN  0) ,  BUFFERSIZE  should 
never  exceed  3400.  bytes  or  IOX  generates  unpredictable  data  compare 
errors . 

Although  read/write  buffers  are  used  for  FILES11  disk  testing  and  for 
NFS  testing  with  DECtapes,  the  buffersize  for  these  devices  is  fixed. 
A  512. -byte  buffer  is  used  for  all  FILES11  testing.  A  1024. -byte 
buffer  is  used  for  all  DECtape  testing. 

The  BUFFERSIZE  command  is  valid  only  in  Command  Mode  when  used  by 
itself.  In  addition,  it  is  valid  only  if  units  are  not  currently 
selected;  that  is,  you  must  set  your  default  buffersize  before  you 
select  any  units  for  testing.  However,  you  can  use  the  buffersize 
command  in  the  SELECT  and  VERIFY  command  lines  to  override  the  default 
buffersize  for  the  selected  device  as  long  as  you  set  the  buffersize 
smaller  than  the  default. 


The  initial  default  is  1024.  bytes. 
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COMPAREDATA 


COM [ PAREDATA]  Y[ES]/N[0] 

COMPAREDATA  is  a  device-dependent  parameter  command  for  FILES11  and 
SELECT  that  applies  to  the  testing  of  devices. 

COMPAREDATA  enables  or  disables  the  checking  of  the  data  pattern. 
COMPAREDATA  YES  enables  data  pattern  checking;  COMPAREDATA  NO 
disables  data  pattern  checking.  When  you  direct  IOX  to  compare  data 
patterns,  it  compares  the  data  that  it  writes  to  the  unit  with  the 
data  it  reads  from  the  unit.  If  the  data  read  does  not  match  the  data 
written,  IOX  prints  a  data  compare  error  report.  Section  4.10.2.1 
discusses  data  compare  error  reports  in  detail. 

You  can  use  COMPAREDATA  within  the  command  lines  of  FILES11  and  SELECT 
to  override  the  current  COMPAREDATA  setting  for  the  device  beinq 
tested. 


The  initial 


default  is  COMPAREDATA  YES. 
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CONFIGURE 


CONF [ IGURE]  [dduu: [=type] ]  .... 

CONFIGURE  is  a  general  parameter  command  and  a  display  command.  You 
use  CONFIGURE  as  a  parameter  command  to  add  devices  to  your  test 
configuration  and  as  a  display  command  to  display  the  current 
configuration. 

IOX  configures  by  default  one  of  each  supported  device  type  as  unit 
"0” .  You  can  add  any  device  to  the  test  configuration  to  which  you 
can  assign  a  logical  device  name  by  using  the  MCR  ASN  command.  When 
you  configure  a  device,  IOX  adds  the  device  to  its  list  of  devices 
available  for  testing  and  creates  an  empty  data  structure  for  the 
device . 

If  a  device  is  not  already  included  in  the  test  configuration,  you 
must  configure  it  before  you  can  select  it  for  testing.  IOX  does  not 
unconfigure  devices  at  the  end  of  an  exercise.  Once  you  have  included 
a  device  in  the  test  configuration,  only  RESTART  will  unconfigure  it. 

CONFIGURE  with  no  qualifiers  displays  the  current  test  configuration. 
To  find  out  if  a  device  is  already  configured,  type: 


I OX> CON FIGURE 


IOX  responds: 


Disks : 

DBO  DDO 

DFO 

DKO 

DLO 

DM0 

DXO  DYO 

EMO 

SYO 

Tapes : 

CTO  DTO 

MFO 

MMO 

MSO 

MTO 

DRO 


DSO 


DUO 


To  add  devices  to  the  test  configuration,  type: 

I 0X> CONF IGURE  DK1 :  DB1 :  DB2:  XX:  YY:  MM 5 :  MQ1 : =TAPE 

This  command  line  configures  devices  DK1 : ,  DB1 : ,  DB2 : ,  XXO:,  and  YYO : 
as  disk  units.  It  configures  devices  MM 5 :  and  MQ1 :  as  tape  units. 

You  must  separate  unit  specifications  with  spaces  or  tabs. 

Use  the  display  form  of  CONFIGURE  to  check  that  these  devices  have 
been  added  to  your  configuration: 

IOX>CONF 

Disks : 


DBO  DB1 

DB2 

DDO 

DFO 

DKO 

DK1 

DLO 

DM0  DPO 

DRO  DSO 

DUO 

DXO 

DYO 

EMO 

SYO 

XXO 

YYO 

Tapes : 

CTO  DTO 

MFO 

MMO 

MM5 

MQ1 

MSO 

MTO 
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CONFIGURE  (Cont.) 


The  device  type  defaults  are  as  follows 
type  when  you  configure  a  device: 


if  you  do  not  specify  a  device 


1.  If  one  unit  of  a  device  type  has  already  been  configured  as  a 
disk,  then,  if  you  add  a  unit  with  the  same  device 
specification,  IOX  also  configures  that  unit  as  a  disk.  For 
example,  since  DKO:  and  DBO:  in  the  previous  example  are 

configured  as  disks  in  the  default  configuration,  IOX 
configures  DK1 : ,  DB1 : ,  and  DB2 :  as  disks.  By  the  same 

logic,  IOX  configures  MM5 :  as  a  tape  because  MMO:  has  been 
configured  as  a  tape  unit  by  default. 


IOX  maintains  consistency  in  configuring  device  units. 
Therefore,  you  cannot  configure  DK1 : ,  DB1 : ,  or  DB2 :  as 
tapes.  The  same  holds  true  for  MM5:  —  you  cannot  configure 
it  as  a  disk.  In  both  cases,  IOX  generates  the  following 
error  message: 


IOX 


dduu:  specified  device  type  is  inconsistent 


2.  For  devices  with  mnemonics  that  have  not  been  previously 
configured,  the  default  is  disk.  Hence,  in  the  following 
example,  IOX  configures  both  XX:  and  YY:  as  disks,  and  MQ1 : 
as  a  tape. 


IOX>CONF  DK1 :  DB1 :  DB2 :  XX:  YY:  MM5 :  MQ1 : =TAPE 


IOX  responds  by  displaying  the  following  messages: 


IOX 

IOX 


XXO:  device  type  not  specified 
YYO :  device  type  not  specified 


defaulting 

defaulting 


to  'DISK* 
to  'DISK' 
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CTRL/C 


CTRL/C  is  a  control  command.  In  Command  Mode  and  Interactive  Mode, 
CTRL/C  generates  an  MCR  prompt  "MCR>"  allowing  you  to  enter  one  MCR 
command  line.  The  function  of  CTRL/C  in  Execution  Mode  depends  on 
whether  CONTROL_C  has  been  set  YES  or  NO.  If  you  have  set  CONTROL_C 
NO,  then  CTRL/C  generates  the  MCR  prompt  "MCR>"  as  it  does  in  Command 
and  Interactive  Modes.  If  you  have  set  CONTROL_C  YES,  then  CTRL/C 
exits  IOX  from  Execution  Mode  and  enters  Interactive  Mode. 

Section  4.9  describes  the  three  IOX  operation  modes  in  detail. 

CTRL/C  exits  to  MCR  by  default  in  Command  and  Interactive  Modes.  In 
Execution  Mode,  CTRL/C  exits  Execution  Mode  and  enters  Interactive 
Mode  by  default. 
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CONTROI _ C 


CONT [ ROL_C]  Y[ES]/N[0] 

CONTROL_C  is  a  general  parameter  command.  You  use  CONTROL_C  to  enable 
or  disable  the  use  of  CTRL/C  to  interrupt  an  I/O  exercise. 

Command  Mode 

CTRL/C  gives  control  to  MCR  for  one  command  line.  The  CONTROL_C 
parameter  has  no  affect  on  CTRL/C  in  Command  Mode. 

Execution  Mode 

If  you  have  set  CONTROL_C  NO,  then  CTRL/C  gives  control  to  MCR 
and  you  receive  the  MCR  prompt  H>H  every  time  you  press  the 
RETURN  key  and  ,,MCR>”  every  time  you  press  CTRL/C  until  the 
exercise  has  terminated.  With  CTRL/C  disabled,  you  cannot 
interrupt  the  exercise  to  enter  IOX  commands.  However,  you  can 
terminate  it  with  the  MCR  ABORT  command  and  issue  other  MCR 
commands  while  an  exercise  is  in  progress. 

If  you  have  set  CONTROL_C  YES,  IOX  will  not  accept  any  input  from 
your  terminal  except  CTRL/C.  If  you  try  to  enter  anything  but 
CTRL/C,  you  receive  the  following  error  message  for  each  key  you 
press : 

IOX  —  Only  ~C  allowed 

When  you  press  CTRL/C,  you  receive  the  IOX  prompt  instead  of  the 
MCR  prompt  and  IOX  exits  Execution  Mode  and  enters  Interactive 
Mode. 

Interactive  Mode 

You  have  access  to  Interactive  Mode  only  if  CONTROL__C  is  enabled. 
In  Interactive  Mode,  you  can  enter  most  IOX  commands.  The  RETURN 
key  and  CTRL/C  have  the  same  functions  in  Interactive  Mode  that 
they  have  in  Command  Mode. 

Section  4.9  describes  the  three  IOX  operation  modes  in  detail. 

The  initial  default  is  CONTROL  C  YES. 
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DENSITY 


DEN [SITY]  dduu :  [nl 

DENSITY  is  a  device-dependent  parameter  command  and  a  display  command. 
The  DENSITY  command  applies  only  to  magnetic  tape  testing  and  requires 
a  magnetic  tape  device  specification  for  "dduu:". 

You  use  DENSITY  as  a  device-dependent  parameter  command  with  an 
argument  "n"  to  set  the  density  and  characteristic  word  of  a  magnetic 
tape.  (The  device  characteristic  word  is  defined  in  the  RSX11M  Guide 
to  Writing  an  I/O  Driver.)  You  issue  the  DENSITY  command  before  you 
select  the  tape  for  NFS  testing  with  SELECT.  You  can  also  set  the 
tape  density  for  a  magnetic  tape  unit  by  using  the  DENSITY  command 
within  the  SELECT  command  line. 

You  set  all  tape  densities  in  bits  per  inch  (bpi)  using  decimal  values 
for  "n" .  The  following  tape  densities  are  legal: 


MF: 

MM: 

MS: 

MT: 

1600 

800 

1600 

200 

1250 

1600 

556 

800 

You  use  DENSITY  as  a  display  command  without  an  argument  "n"  to 
display  the  current  density  of  the  specified  magnetic  tape  unit.  For 
example : 

I OX>DENSITY  MM: 

Density=  1600  BPI  Characteristic  Word=  004004  (octal) 

This  command  line  displays  the  current  density  and  characteristic  word 
for  MM0:.  To  change  the  tape  density  to  &00,  you  type: 

IOX>DENSITY  MM:  800 

The  DENSITY  command  is  the  only  way  you  can  find  out  what  the  current 
DENSITY  setting  is  on  a  magnetic  tape,  because  DENSITY  is  not 
displayed  by  the  PARAMETERLIST  command. 

To  display  the  new  tape  density  and  characteristic  word  for  MM0:,  you 
type : 


IOX>DENSITY  MM: 

Density=  800  BPI  Characteristic  Word=  000000  (octal) 

For  tapes  other  than  MT,  MM,  MS,  and  MF,  you  enter  the  density  in 
decimal  but  IOX  displays  the  density  in  octal  as  the  characteristic 
word.  For  example: 

IOX>DENS  MQ: 

Density=  ????  BPI  Characteristic  Word=  004004  (octal) 
IOX>DENS  MQ:  800 
I OX>DENS  MQ: 

Density=  ????  BPI  Characteristic  Word=  001440  (octal) 
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This  command  sequence  indicates  that: 

•  IOX  does  not  know  the  density  of  the  tape  designated  as  MQ: . 
The  characteristic  word  is  the  default. 

•  When  you  set  the  density  of  MQ:  to  800  bpi  (decimal)  and 
display  the  current  density  and  characteristic  word,  the 
density  appears  in  the  characteristic  word  (octal) . 

Except  for  MT:  devices,  the  initial  default  density  for  magnetic  tape 
devices  is  1600  bpi.  The  initial  default  for  MT:  devices  is  800  bpi. 
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DES [ ELECT]  ddnn: 

DESELECT  is  an  IOX  function  command.  You  use  DESELECT  to  "deselect" 
devices  that  you  have  selected  for  testing  with  SELECT,  VERIFY,  or 
FILES11.  DESELECT  requires  device  (dd)  and  unit  (nn)  specifications. 

If  you  issue  the  DESELECT  command  in  Interactive  Mode  (while  testing 
of  the  specified  device  is  in  progress) ,  testing  on  the  device 
terminates  and  the  device  is  removed  from  the  list  of  devices  to  be 
tested.  If  you  issue  the  command  in  Command  Mode  (while  no  testing  is 
in  progress),  then  DESELECT  only  removes  the  device  from  the  list  of 
devices  to  be  tested. 

For  devices  that  you  have  selected  for  NFS  testing,  DESELECT  does  the 
following : 

•  Terminates  I/O  operations  (if  they  are  in  progress) 

•  Deletes  the  badblocks  list  associated  with  the  device  (disks 
only) 

•  Deallocates  all  buffer  space 

•  Detaches  IOX  from  the  device 

For  devices  that  you  have  selected  for  FILES11  testing,  DESELECT  does 
the  following: 

•  Terminates  I/O  operations  (if  they  are  in  progress) 

•  Closes  and  deletes  the  temporary  file 

•  Deallocates  all  buffer  space 

The  DESELECT  command  does  not  remove  a  device  from  the  test 
configuration. 
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ER [RORLIMIT]  n 

ERRORLIMIT  is  a  device-dependent  parameter  command  that  sets  the 
maximum  number  of  errors  that  IOX  will  tolerate  between  interval 
reports  before  deselecting  a  device. 

You  use  the  SUMMARYTIME  command  to  determine  how  often  IOX  generates 
interval  reports.  If  you  request  interval  reports  every  two  minutes 
(SUMMARYTIME  2)  and  set  ERRORLIMIT  at  10  errors,  IOX  will  allow  not 
more  than  10  errors  on  a  device  in  a  two-minute  interval  before 
deselecting  the  device  from  testing. 

You  can  also  use  the  ERRORLIMIT  command  within  the  FILES11,  SELECT, 
and  VERIFY  command  lines  to  override  the  default  error  limit  for  the 
device  being  selected  for  testing. 

The  initial  default  is  10  errors. 
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EXE [CUTE]  taskname  commandstring 

EXECUTE  is  a  function  command.  You  use  EXECUTE  to  direct  a  command 
line  to  the  operating  system  for  execution.  The  task  you  want  to  run 
must  be  installed.  For  the  EXECUTE  command  to  operate,  your  system 
must  support  task  spawning.  The  rules  for  using  the  SPWN$  directive 
and  entering  command  lines  apply  to  the  arguments  for  taskname  and 
commandstring  in  the  EXECUTE  command  line  (see  the  RSX-11M/M-PLUS 
Executive  Reference  Manual ) . 

When  you  issue  the  EXECUTE  command  in  Interactive  Mode  (testing  in 
progress)  ,  the  task  you  have  initiated  with  EXECUTE  runs  immediately. 
When  you  issue  the  EXECUTE  command  in  Command  Mode  (no  testing  in 
progress)  ,  IOX  queues  the  task  for  execution.  The  task  begins 
executing  when  you  start  an  exercise  with  the  START  command. 

Tasks  you  initiate  with  EXECUTE  run  in  parallel  with  I/O  exercises. 
For  example,  you  use  the  EXECUTE  command  to  run  the  BAD  utility  to 
list  at  your  terminal  the  bad  blocks  on  an  NFS  disk.  You  can  then 
enter  this  information  in  the  IOX  badblocks  list  so  that  IOX  does  not 
try  to  perform  I/O  operations  on  the  blocks  that  are  bad. 

To  run  the  BAD  utility  on  NFS  disk  DLO:,  type 

IOX>EXE  ...BAD  #DL0:/LI 

In  this  case,  you  must  include  the  pound  sign  (#)  as  shown  in  the 
command  line.  For  tasks  such  as  BAD  whose  command  line  processing 
requires  a  leading  space,  IOX  converts  the  pound  sign  to  a  space.  A 
task  such  as  PIP  does  not  require  a  leading  space  in  its  command  line. 
For  these  tasks  you  do  not  need  to  include  the  pound  sign  in  the 
command  line. 

You  can  also  use  the  EXECUTE  command  to  run  a  task  to  do  system 
testing  while  IOX  is  doing  I/O  testing.  For  example,  if  you  have 
written  a  CPU  exerciser  task  and  installed  the  task  as  . . . QWK ,  then 
you  can  run  this  task  in  parallel  with  the  I/O  Exerciser  by  entering 
the  command  line 

IOX>EXECUTE  ...QWK  /CPU=1144 
IOX>START 

where  /CPU=1144  is  the  command  line  to  be  passed  to  task  ...QWK. 

To  remove  a  task  from  the  list  of  tasks  to  be  executed  and  terminate 
execution  of  the  task  (if  the  task  is  in  progress),  you  use  the  ABORT 
command . 


i 
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EXIT  is  a  control  command.  You  use  the  EXIT  command  to  terminate  IOX 
processing  and  exit  from  IOX  to  the  operating  system  monitor. 
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Ffilesll]  dduu:  [command=qualif ier]  ... 

FILES1.1  is  a  function  command.  You  use  FILES11  to  select  a  Files-11 
disk  for  an  I/O  exercise.  Testing  a  disk  with  FILESll  protects  the 
contents  and  structure  of  the  disk,  because  IOX  writes  into  a 
temporary  file  that  IOX  removes  from  the  disk  at  the  end  of  the  test. 
You  must  first  configure  the  disk  if  it  is  not  already  in  the  test 
configuration  before  you  can  select  it  for  testing. 

When  you  select  a  disk  using  FILESll,  you  can  override  the  default 
parameters  by  using  the  following  device-dependent  parameter  commands 
in  the  FILESll  command  line: 

COMPAREDATA 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

TEMPORARYFILE 

The  following  example  uses  some  of  them. 

I0X>FILES11  DBO :  COMPAREDATA=YES  RANDOM=NO  TEMPORARYFILE=600 

This  command  line  selects  DBO:  for  I/O  exercising.  IOX  compares  data 
read  with  data  written,  sequentially  accesses  the  blocks  in  the  file, 
and  opens  a  600-block  temporary  file.  Example  4-1  in  Section  4.7 
illustrates  and  discusses  how  you  test  an  RL02  with  FILESll. 

Once  you  have  selected  a  device,  the  default  parameters  for  that 
device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device . 

When  you  issue  the  FILESll  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress),  IOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  FILESll  command  in  Command  Mode 
(while  no  exercise  is  in  progress) ,  IOX  includes  the  specified  device 
in  its  list  of  devices  to  exercise  but  does  not  begin  the  exercise 
until  you  start  the  exercise  with  the  START  command. 

If  no  commands  are  specified  within  the  FILESll  command  line,  the 
device  is  exercised  with  the  default  parameters  currently  in  effect. 
Commands  can  only  be  separated  by  spaces  or  tabs. 
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HELP 


HELP  is  a  display  command.  You  type  HELP  to  display  a  summary  of  IOX 
commands  at  your  terminal. 


c 

c 

c 


c 
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INTERLEAVE]  number 

INTERLEAVE  is  a  parameter  command  that  sets  a  device-dependent 
parameter  for  disk  testing.  The  INTERLEAVE  command  sets  the  number  of 
blocks  to  be  skipped  before  IOX  writes  the  next  buffer  of  data.  The 
INTERLEAVE  factor  applies  only  to  sequential  testing:  that  is,  if  you 
have  set  RANDOM  NO.  If  you  have  set  RANDOM  YES,  IOX  tests  blocks  on 
the  disk  randomly  and  ignores  the  INTERLEAVE  factor.  The  initial 
default  for  RANDOM  is  RANDOM  YES. 

You  can  use  the  INTERLEAVE  command  within  the  FILES11,  SELECT,  and 
VERIFY  command  lines  to  override  the  current  default  for  the  disk 
being  selected. 

The  initial  default  is  four  blocks. 
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L [OGFILE]  Y[ES]/N[0] 

LOGFILE  is  a  general  parameter  command.  You  use  the  LOGFILE  command 
to  direct  activity  and  error  Reports  either  to  your  terminal  or  to  a 
log  file  in  your  default  disk  area.  Section  4.10  discusses  the 
content  and  format  of  activity  and  error  reports  in  detail. 

LOGFILE  NO  directs  activity  and  error  reports  to  your  terminal. 
LOGFILE  YES  directs  activity  and  error  reports  to  the  log  file. 
Summary  reports,  which  IOX  generates  when  you  issue  the  PRINTSUMMARY 
command,  are  displayed  at  your  terminal  regardless  of  how  you  have  set 
LOGFILE. 

IOX  does  not  open  a  new  log  file  each  time  you  run  an  exercise  with 
LOGFILE  enabled.  It  creates  the  file  when  you  first  run  an  exercise 
and  then  appends  to  it.  The  file  is  in  your  area  and  is  named: 

yyyyyy.LOG 

where  yyyyyy  is  the  name  of  the  task  currently  running  IOX  on  your 
terminal  (IOX,  another  task  name,  or  the  name  of  your  terminal,  for 
example  TT10) . 

In  addition  to  activity  and  error  reports,  IOX  inserts  the  following 
date  and  time  information  into  the  log  file: 

•  When  the  exercise  began  followed  by  the  output  of  the 
PARAMETERLIST  command 

•  When  the  exercise  ended 

•  When  a  log  file  was  started 

•  When  log  file  entries  were  terminated 

•  When  an  exercise  was  aborted 

For  example,  all  exercises  begin  with  an  event  line  such  as: 

IOX  —  20-JUL-81  11:15:24  ********  EXERCISER  STARTED  ******** 
and  end  with  an  event  line  such  as: 

IOX  —  20-JUL-81  11:20:34  ********  EXERCISER  TERMINATED  ******** 
The  initial  default  is  LOGFILE  NO. 


C 
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PAR [AMETERLIST] 


PARAMETERLIST  is  a  display  command.  PARAMETERLIST  displays  at  least 
two  kinds  of  information.  For  example: 

I 0X> PARAMETERLIST 


BUFFERSIZE3  1024. 
ERRORLIMIT=  10. 
INTERLEAVE=  4. 
PATTERN=  0. 

RECORDS3  1024. 
RUNTIME3  5. 
SUMMARYTIME3  1. 
TEMPORARYFILE3  500. 


COMPAREDATA3  YES  ~\ 

CONTROL_C=  YES 
LOGFILE3  NO 
RANDOM3  YES 

REPORTERRORS=  YES  >  O 

RETRIES=  YES 
VOLUMECHECK=  YES 
WAIT=  YES 

WRITECHECK=  NO  J 


Buffer  space  usage=  3290 •: 1924 1924 1 .  © 


O  The  current  default  parameters 
©  IOX  buffer  space  statistics 


At  most,  PARAMETERLIST  displays  four  kinds  of  information: 

•  Current  execution  default  parameters 

•  IOX  buffer  space  statistics 


IOX  may  also  list  the: 

•  List  of  tasks  initiated  by  the  EXECUTE  command 

•  Devices  selected  for  testing  with  FILES11,  SELECT,  and  VERIFY 

Example  4-5  describes  the  information  in  the  four  parts  of  the 
PARAMETERLIST  display  that  correspond  to  these  four  kinds  of 
information . 


Example  4-5  PARAMETERLIST  Display  Shown  in  Four  Parts 


IOX>EXECUTE  ♦♦♦BAD  *DL0!/LI  © 

IOX>FILESU  SY:  TEMP0RARYFILE=800  ERR0RLIhIT=50  © 

IQX>SELECT  MMOt  RECGRDS=350  BUFFERSI ZE=700  RETRIES=NO 
IOX>VERIFY  DM0  ♦  RANGE  20051000  RAND0M=N0  INTERLEAVE=8  © 
IQX>PARAMETERLIST 


Device 

Mode 

Buf f ersize 

Filesize/Records/RanSe 

Par 

a  m  e  t  e  r  s 

DM0 : 

VFY 

1024. 

200.  ->  1,000. 

RET 

I NT  =  8 ♦  E  R  R  = 1 0 ♦ 

O 

>© 

mmo: 

SEL 

700. 

350. 

COM 

E  R  R  =  1 0  ♦ 

syo: 

FI  1 

512. 

800. 

COM 

RET  RAN  E R R  =  5 0 ♦ 

o  > 

(continued  on  next  page) 
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Example  4-5  (Cont.)  PARAMETERLIST  Display  Shown  in  Four  Parts 


Task 

Status 

Command  line 

...  BAD 

QUEUED 

dlo:/li 

BUFFERSIZE*  1024* 
ERRORLIMIT*  10* 
INTERLEAVE*  4. 
PATTERN*  0. 

RECORDS*  1024 » 
RUNTIME*  5 « 
SUMMARYTIME*  1. 
TEMPORARYFILE*  500. 


COMPAREDATA*  YES 
CONTROL. C=  YES 
LOGFILE*  NO 
RANDOM*  YES 
REPORTERRORS*  YES 
RETRIES*  YES 
VOLUMECHECK*  YES 
WAIT*  YES 
WRITECHECK*  NO 


o 


Buffer  space  usage*  5338 *  *  1020 .♦ 1588 ♦ ♦ 2 .  © 


Q  Current  defaults  at  the  time  you  entered  the  PARAMETERLIST 
command.  None  of  the  defaults  have  been  changed  by  the 
command  sequence  in  the  example.  These  are  the  initial 
default  parameters.  You  can  alter  the  default  for  these 
parameters.  See  the  description  for  the  appropriate  command 
in  this  section. 

©  IOX  buffer  space  statistics.  The  form  of  these  statistics 
is  the  following: 

totalmemory : freeblock: f reebytes : fragments 
totalmemory 

Size  of  IOX  buffer  space  in  bytes, 
freeblock 

Size  of  the  largest  free  block  of  IOX  buffer  space  in 
bytes. 

f reebytes 

Total  amount  of  free  bytes  available  in  IOX  buffer 
space. 

fragments 

Number  of  memory  fragments  in  IOX  buffer  space. 

In  the  examples,  these  statistics  have  changed  to  reflect 
the  buffer  allocations  for  the  three  devices  that  you 
selected  for  testing. 

©  Selected  devices  and  their  device-dependent  parameters. 
These  parameters  correspond  to  the  default  parameters  unless 
you  have  overridden  the  defaults  in  the  command  line  that 
you  used  to  select  the  devices. 
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This  part  of  the  display  has  five  fields  that  are  labeled  by 
function.  They  are: 

device 

Device  mnemonic  of  the  selected  device. 


mode 


Testing  mode  selected,  either  VERIFY  (VFY) ,  SELECT 
(SEL) ,  or  FILES11  (Fll) . 

buf fersize 

Buffersize  used  for  reading  data  from  the  device  and 
writing  data  to  the  device.  You  can  alter  the 
buffersize  for  magnetic  tapes,  NFS  disks,  and 
cassettes.  Files-11  disks  have  a  fixed  buffersize  of 
512.  bytes.  DECtapes  have  a  fixed  buffersize  of  1024. 
bytes. 

f ilesi ze/records/range 

One  of  the  following: 

•  Temporary  file  size  in  blocks  for  disks  selected 
with  FILES11. 

•  Number  of  records  to  test  for  magnetic  tapes  and 
cassettes  selected  with  the  SELECT  command. 

•  Range  of  blocks  to  be  tested  on  NFS  disks  that  you 
selected  with  the  SELECT  or  VERIFY  command. 

parameter 

Device  dependent  parameters.  These  either  specify  a  value, 
such  as  INT=8 •  or  ERR=10.  (INTERLEAVE  8  or  ERRORLIMIT  10), 
or  their  presence  indicates  that  you  have  set  a  YES/NO 
parameter  to  YES.  For  example,  in  (4)  RAN  means  that  you 
set  RANDOM  YES;  and,  in  (6),  the  absence  of  RAN  means  that 
you  set  RANDOM  NO.  See  Section  4.6  for  a  list  of  what 
parameters  apply  to  what  devices  and  modes  of  testing. 

O  This  display  line  corresponds  to  the  command  line  discussed 
next . 

©  This  is  the  command  line  that  you  used  to  select  SY:  for 

FILES11  testing,  overriding  the  TEMPORARYFILE  and  ERRORLIMIT 
defaults.  IOX  tests  SY:  as  a  Files-11  device,  using  a 
512-byte  data  buffer  (fixed)  and  a  TEMPORARYFILE  size  of  800 
blocks,  with  COMPAREDATA  enabled  (by  default),  RETRIES 
enabled  (by  default) ,  RANDOM  YES  (by  default) ,  and  an  error 
limit  of  50  errors. 

0  The  display  line  corresponding  to  the  command  line  discussed 
next. 
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The  command  line  you  used  to  select  DM0:  with  VERIFY.  IOX 
tests  DM0:,  using  the  VERIFY  mode  with  the  default 
buffersize  of  1024.  bytes,  over  the  range  of  blocks  200 
through  1000,  with  RETRIES  enabled  (by  default),  RANDOM 
disabled,  the  INTERLEAVE  factor  set  to  8,  and  the  default 
error  limit  of  10. 


©  The  list  of  tasks  initiated  by  the  EXECUTE  command 
corresponding  to  the  command  line  discussed  next. 

This  part  of  the  display  has  the  following  fields: 

•  Task  Installed  —  taskname  (...BAD) 


•  Status  Execution  —  status  (QUEUED,  ACTIVE,  SUCCESS, 
WARNING,  ERROR,  SEVERE  ERROR) 

•  Command  Line  —  line  passed  to  the  task 

The  command  line  you  used  to  execute  the  BAD  utility. 

In  Command  Mode  you  can  use  CTRL/O  to  suppress  the  output  of 
PARAMETERLIST.  In  Interactive  Mode,  CTRL/O  has  no  affect  on  the 
output. 


e 
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PAT [TERN]  [patternnumber] 

PATTERN  is  a  general  parameter  command  and  a  display  command.  You  use 
PATTERN  as  a  parameter  command  (with  an  argument)  to  set  the  pattern 
that  IOX  writes  and  reads  during  I/O  testing.  The  PATTERN  display 
command  (with  no  argument)  displays  all  13  patterns  and  shows  the 
pattern  that  is  the  current  default  with  an  asterisk  (*) . 


The  following  example  illustrates  the  default  pattern  when  you  use 
PATTERN  as  a  display  command: 


IOX>PATTERN 

0  =  Random  Data 

1  =  000000,000000 

2  =  177777,177777 

3  =  125252,052525 

4  =  165555,133333 

5  =  163126,163126 

6  =  055555,155555 

7  =  022222,122222 

8  =  111111,111111 

9  =  007417,007417 

10  =  021042,021042 

11  =  104210,104210 

12  =  052652,052652 


To  change  the  default  pattern  from  random  data  to  "125252,052525", 
which  is  pattern  3,  you  type: 


IOX>PATTERN  3 


Using  the  display  form  of 
from  pattern  0  to  pattern 


PATTERN  now  shows  that 
3  after  you  changed  the 


the  asterisk  moved 
default : 


I OX>PATTERN 

0  =  Random  Data 

1  =  000000,000000 

2  =  177777,177777 

3  =  125252,052525  * 

4  =  165555,133333 

5  =  163126,163126 

6  =  055555,155555 

7  =  022222,122222 

8  =  111111,111111 

9  =  007417,007417 

10  =  021042,021042 

11  =  104210,104210 

12  =  052652,052652 


The  form  of  the  PATTERN  command  that  changes  the  pattern  default  is 
valid  only  in  Command  Mode. 


Pattern  0  is  random  data  from  pure  portions  of  the  I/O  Exerciser 
itself.  When  you  use  the  random  data  pattern,  the  buffersize  should 
never  exceed  3400.  bytes  or  IOX  will  generate  unpredictable  data 
compare  errors. 


The  initial  default  pattern  is  random  data,  pattern  0. 
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PR I [NTSUMMARY] 

PRINTSUMMARY  is  a  display  command  that  is  valid  only  in  Interactive 
Mode. 

IOX  outputs  activity  reports  and  error  reports.  Activity  reports 
summarize  IOX  processing  information,  such  as  how  long  an  exercise 
will  run  and  how  many  ASTs  have  been  executed.  There  are  three  kinds 
of  activity  reports:  accumulated  totals,  interval  reports,  and 
summary  reports.  (For  a  complete  description  of  these  three  kinds  of 
activity  reports,  see  Section  4.10.) 

Summary  reports  and  interval  reports  have  the  same  content  and  format. 
However,  IOX  generates  interval  reports  at  the  time  intervals  that  you 
have  set  with  the  SUMMARYTIME  command.  IOX  generates  summary  reports 
when  you  enter  the  PRINTSUMMARY  command  in  Interactive  Mode.  A 
summary  report  summarizes  IOX  activity  between  the  last  interval 
report  and  the  time  you  enter  the  PRINTSUMMARY  command.  IOX  displays 
summary  reports  at  your  terminal  even  if  LOGFILE  is  enabled. 
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PRO [ CEED] 

PROCEED  is  a  control  command  that  you  use  only  in  Interactive  Mode. 
(Section  4.9  describes  the  three  IOX  operating  modes  in  detail.)  When 
you  enter  the  PROCEED  command ,  IOX  exits  Interactive  Mode,  enters 
Execution  Mode,  and  checks  for  IOX  activity.  If  no  exercises  are  in 
progress  and  no  tasks  initiated  by  IOX  are  executing,  then  IOX 
terminates  the  exercise. 

If  there  is  activity,  IOX  resumes  display  of  activity  and  error 
reports  to  your  terminal  if  you  have  set  LOGFILE  NO.  (With  LOGFILE 
disabled,  IOX  suspends  activity  and  error  reports  to  your  terminal  in 
Interactive  Mode.  With  LOGFILE  enabled,  IOX  continues  recording 
activity  and  error  reports  in  the  log  file.) 

Use  the  PROCEED  command  only  if  you  want  IOX  to  terminate  an  exercise 
as  soon  as  activity  terminates  or  if  you  want  IOX  to  resume  display  of 
activity  and  error  reports  at  your  terminal  with  LOGFILE  disabled. 
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RANDOM 


RAND [ OM]  Y[ES]/N[0] 


RANDOM  is  a  device-dependent  parameter  command  that  applies  to  disk 
testing.  The  RANDOM  command  directs  IOX  to  select  either  random  or 
sequential  blocks  for  disk  testing. 

RANDOM  YES  directs  IOX  to  use  its  random  number  generator  to  choose 
the  blocks  on  the  selected  disk  for  exercising.  RANDOM  NO  directs  IOX 
to  sequentially  test  blocks  on  the  disk. 


If  you  set  RANDOM  NO,  then  IOX  skips  the  number  of  blocks  specified 
with  the  INTERLEAVE  command  before  testing  the  next  block.  For 
example : 


I 0X> INTERLEAVE  8 
I OX>RANDOM  NO 


In  this  example,  IOX  tests  every  eighth  block  on  the  disk  (that  is, 
block  0,7,15,.  .  .  .). 

You  can  use  the  RANDOM  command  within  the  FILES11,  SELECT,  and  VERIFY 
command  lines  to  override  the  current  default  parameter  for  selecting 
blocks  for  testing. 


The  initial  default  is  RANDOM  YES. 
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RANGE 


RANG [ E ]  dduu:  [minimum:maximum] 

RANGE  is  a  device-dependent  parameter  command  and  a  display  command. 
The  RANGE  command  applies  only  to  disks  that  you  have  selected  for  NFS 
testing  with  SELECT  or  VERIFY. 

RANGE  as  a  parameter  command  sets  the  minimum  and  maximum  block 
numbers  for  NFS  testing  on  the  specified  disk  unit.  For  example: 

IOX>RANGE  DLO :  300:500 

IOX  tests  blocks  in  the  range  300  through  500  on  DLO.  This  form  of 
the  RANGE  command  can  be  used  in  the  SELECT  or  VERIFY  command  lines  to 
specify  the  range  of  blocks  to  be  tested. 

RANGE  as  a  display  command  displays  the  current  range  of  blocks  to  be 
tested  on  the  specified  disk  unit.  The  device  must  have  been  selected 
for  testing. 

For  example: 

IOX>RANGE  DLO: 

0.  ->  20,420. 

This  is  the  default  for  RL02s.  After  you  issue  the  RANGE  command  in 
the  previous  example,  you  can  use  the  RANGE  command  to  display  the 
current  range  of  blocks  to  be  tested: 

I0X>RANGE  DLO: 

300.  ->  500. 

This  form  of  the  RANGE  command  cannot  be  used  within  the  SELECT  or 
VERIFY  command  lines. 

The  default  range  for  all  disks  that  have  been  selected  is  zero  to  the 
maximum  block  number  on  the  disk  minus  sixty  (0:maximum-60) . 
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RECORDS 


REC [ORDS]  recordcount 


RECORDS  is  a  device-dependent  parameter  command  that  applies 
testing  of  magnetic  tapes  and  cassettes  with  SELECT, 
specifies  a  recordcount,  which  is  the  number  of  records 
magnetic  tape  or  cassette  to  be  exercised.  For  example: 


to  the 
RECORDS 
on  the 


IOX>RECORDS  200 


This  command  line  directs  IOX  to  exercise  200  records  on  all  magnetic 
tapes  and  cassettes.  RECORDS  0  directs  IOX  to  test  the  records  on 
magnetic  tapes  and  cassettes  until  it  detects  the  end  of  the  tape,  at 
which  time  IOX  displays  an  end  of  tape  message  and  deselects  the  tape 
unit. 

You  can  use  RECORDS  in  the  SELECT  command  line  to  override  the  default 
recordcount  for  the  magnetic  tape  or  cassette  being  selected. 

The  initial  default  is  1024.  records. 


C 

o 
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REP [ORTERRORS]  Y[ES]/N[0] 

REPORTERRORS  is  a  general  parameter  command  that  you  use  to  enable 
(REPORTERRORS  YES)  or  disable  (REPORTERRORS  NO)  IOX  error  reports. 
There  are  two  kinds  of  error  reports:  data  compare  error  reports  and 
I/O  error  reports. 

If  a  success  code  is  returned  from  the  device  driver  (meaning  that  a 
QIO  succeeded)  but  the  data  that  IOX  wrote  does  not  match  the  data 
that  IOX  read,  then  a  data  compare  error  has  occurred.  Section 

4.10.2.1  illustrates  and  discusses  data  compare  error  reports. 

I/O  error  codes  are  returned  from  the  device  drivers  (meaning  that  a 

QIO  failed) .  These  error  codes  generate  one  of  12  error  messages 

discussed  in  Sections  4.10  and  4.13. 

IOX  directs  error  reports  to  your  terminal,  but  with  the  following 
restrictions : 

•  Error  reports  never  interrupt  activity  reports. 

•  If  LOGFILE  is  enabled,  IOX  enters  error  reports  in  the  log 
file  instead  of  displaying  them  at  your  terminal. 

•  In  Interactive  Mode,  IOX  suppresses  the  printing  of  error 

reports . 

The  initial  default  is  REPORTERRORS  YES. 
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RESTART 


RES [TART] 

RESTART  is  a  control  command.  The  RESTART  command  is  valid  only  in 
Command  Mode.  When  you  restart  the  I/O  Exerciser,  you  effectively 
reinvoke  IOX  without  exiting  to  the  operating  system  monitor. 

The  RESTART  command  performs  the  following  functions: 

•  Deselects  devices  that  are  selected  for  testing. 

•  Resets  all  parameters  to  their  initial  defaults. 

•  Removes  all  tasks  queued  for  execution  by  the  EXECUTE  command 
from  the  list  of  tasks  to  be  executed. 

•  Unconfigures  all  devices  that  you  added  to  the  default 
configuration. 


N 
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RETRIES 


RET [RIES]  Y[ES]/N[0] 

RETRIES  is  a  device-dependent  parameter  command  that  applies  to  the 
testing  of  magnetic  tapes  and  NFS  disks.  RETRIES  YES  directs  a  device 
driver  to  use  its  standard  recovery  techniques  to  attempt  to  recover 
from  an  error.  RETRIES  NO  inhibits  an  I/O  driver  from  using  its 
standard  recovery  techniques  when  it  encounters  an  error. 

You  can  use  the  RETRIES  command  within  the  SELECT  and  VERIFY  command 
lines  to  override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  RETRIES  YES. 
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RUNTIME 


RUN [TIME]  minutes 

RUNTIME  is  a  general  parameter  command.  RUNTIME  is  valid  only  in 
Command  Mode  (no  exercising  in  progress) . 

You  use  the  RUNTIME  command  to  specify  how  many  minutes  you  want  IOX 
to  test  the  devices(s)  that  you  have  selected  for  testing.  If  you 
specify  RUNTIME  0,  IOX  continues  testing  the  selected  devices  until 
you  abort  the  exercise  with  either  the  IOX  ABORT  command  or  the  MCR 
ABORT  command. 

The  initial  default  is  five  minutes. 
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SELECT 


SE [ LECT]  dduu:  [ command=qual i f i er ]  .... 

SELECT  is  a  function  command.  The  SELECT  command  selects  a  device 
with  an  NFS  volume  mounted  for  an  I/O  exercise  that  destroys  the 
contents  and  structure  of  the  volume.  Before  using  select,  you  must 
first  configure  the  device  if  it  is  not  in  the  test  configuration. 

When  you  use  the  SELECT  command  to  select  a  device  to  be  tested  as  an 
NFS  volume,  you  can  override  the  current  default  parameters  by  using 
the  commands  in  Table  4-3  within  the  SELECT  command  line. 

\ 


Table  4-3 

Parameter  Commands  by  Device  Type  for  the  SELECT  Command 


NFS  Disks 

Cassettes 

DECtapes 

Magnetic 

Tapes 

BUFFERSIZE 

BUFFERSIZE 

COMPAREDATA 

BUFFERSIZE 

COMPAREDATA 

COMPAREDATA 

ERRORLIMIT 

ERRORLIMIT 

ERRORLIMIT 

ERRORLIMIT 

DENSITY 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

VOLUMECHECK 

WRITECHECK 

RECORDS 

RECORDS 

RETRIES 

The  following  command  line  illustrates  some  of  these  commands: 

I OX>SEL  DLO :  RANG=1 00 : 4000  RET=YES  RAND=NO  INT=8  BUF=2000 
This  command  line: 

•  Selects  DLO:  for  I/O  exercising 

•  Tests  only  blocks  100  through  4000 

•  Allows  the  driver  to  retry  I/O  operations  if  it  encounters 
errors 

•  Accesses  the  blocks  on  the  volume  sequentially  testing  every 
eighth  block 

•  Uses  a  data  buffer  of  2000  bytes  for  data  transfer. 

Example  4-2  in  Section  4.8.1  illustrates  and  describes  how  you  test  a 
magnetic  tape  unit  with  the  SELECT  command. 
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SELECT  (Cont.) 


Once  you  have  selected 
device  are  fixed.  You 
device . 


a  device,  the  default 
cannot  reset  them  without 


parameters  for  that 
first  deselecting  the 


When  you  issue  the 
exercise  is  in 
immediately.  When 
no  exercise  is  in 
list  of  devices  to 
start  the  exercise 


SELECT  command  in  Interactive  Mode  (wh 
progress) ,  IOX  begins  testing  the  specified 
you  issue  the  SELECT  command  in  Command  Mode 
progress) ,  IOX  includes  the  specified  device 
exercise  but  does  not  begin  the  exercise  unt 
with  the  START  command. 


ile  an 
device 
(while 
in  its 
il  you 


If  no  further  parameter  commands 
command  line,  the  device  is  exerci 
effect.  Commands  can  only  be  sepa 


are  specified  within 
sed  with  the  parameters 
rated  by  spaces  or  tabs 


the  SELECT 
currently  in 
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SPY 


SP[Y]  [dduu : ] 

SPY  is  a  display  command.  You  issue  the  SPY  command  only  in 
Interactive  Mode  (exercising  in  progress)  to  display  status 
information  on  device(s)  being  tested. 

SPY  without  an  argument  displays  status  information  on  all  devices 
being  tested.  SPY  with  a  device  and  unit  specification  displays 
status  information  only  on  the  specified  device.  For  example: 

>SPY  DBO : 


IOX  outputs  the  following: 

DBO:  —  TYPE=F11  VBN=305.  I/0=AST  queued  FUNCTION=WRITE 

This  output  indicates: 

•  Device  being  exercised  (DBO:) 

•  Type  of  testing  being  performed  on  the  device:  FILES11 

(Fll),  SELECT  (SEL) ,  VERIFY  (VFY) 


Virtual  block  number  being  tested  (305.  in  this  example)  or, 
for  NFS  volumes,  the  logical  block  number 

I/O  request  status:  AST  queued,  in  progress,  or  idle 

Type  of  I/O  function  being  performed:  READ  or  WRITE 


SPY  always  outputs  to  your  terminal,  even  if  LOGFILE  is  enabled. 
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START 


ST [ART] 


START  is  a  control  command.  START  is  valid  only  in  Command  Mode. 
When  you  issue  the  START  command ,  IOX  exits  Command  Mode  and  enters 
Execution  Mode.  Section  4.9  discusses  the  three  IOX  operating  modes 
in  detail. 


After  you  have  set  your  test  configuration  and  selected  the  devices 
you  want  to  test,  you  begin  exercising  the  selected  units  with  the 
START  command.  START  also  turns  on  the  IOX  clock,  begins  activity  and 
error  reporting  (if  you  enabled  error  reporting  with  REPORTERRORS 
YES),  and  begins  executing  tasks  queued  by  the  EXECUTE  command. 


C 

c 

c 

c 
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SUMMARYTIME 


SU [MMARYTIME]  minutes 

SUMMARYTIME  is  a  general  parameter  command  you  use  to  specify  how 
often  (in  minutes)  IOX  outputs  interval  reports.  (See  Section  4.10 
for  a  complete  discussion  of  interval  reports) .  You  can  suppress 
interval  reports  by  setting  SUMMARYTIME  0. 

The  initial  default  is  one  minute. 
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TEMPORARYFILE 


T [ EMPORARYFILE] 


f ilesize 


TEMPORARYFILE  is  a  device-dependent  parameter  command  that  applies  to 
the  testing  of  Files-11  disks  with  the  FILES11  command.  The  FILES11 
command  protects  the  contents  of  the  disk  by  writing  a  temporary  file 
that  IOX  deletes  at  the  end  of  the  exercise.  You  specify  the  filesize 
in  blocks. 


You  can  use  the  TEMPORARYFILE  command  in  the  FILES11  command  line  to 
override  the  current  default  for  the  disk  being  selected. 

The  initial  default  is  500  blocks. 
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VERIFY 


VE [RIFY]  dduu:  [command=qualif ier]  .... 

VERIFY  is  a  function  command  you  use  to  select  a  mounted  NFS  disk  for 
an  exercise.  VERIFY  reads  buffers  of  data  without  writing  on  the 
disk,  performing  data  comparisons,  or  destroying  the  contents  of  the 
disk. 


VERIFY  accepts  the  following  device— dependent  parameter  commands 
within  its  command  line  to  override  the  default  parameters  for  the 
device  being  tested: 


BUFFERSIZE 

ERRORLIMIT 

INTERLEAVE 

RANDOM 

RANGE 

RETRIES 

The  following  example  illustrates  how  you  use  the  ERRORLIMIT  and  RANGE 
commands  within  the  VERIFY  command  line  to  override  the  current 
defaults  for  testing  DM0: 


IOX>VERIFY  DM0:  RANGE  1000:3000  ERRORLIMIT=l 000 

This  command  line  selects  DM0:  for  read  only  testing  of  blocks  1000 
through  3000  (inclusive)  with  a  maximum  of  1000  errors  before  IOX 
deselects  the  disk.  Example  4-3  in  Section  4.8.2  illustrates  and 
explains  how  you  test  an  NFS  disk  with  VERIFY. 

Once  you  have  selected  a  device,  the  default  parameters  for  that 
device  are  fixed.  You  cannot  reset  them  without  first  deselecting  the 
device . 


When  you  issue  the  VERIFY  command  in  Interactive  Mode  (while  an 
exercise  is  in  progress) ,  IOX  begins  testing  the  specified  device 
immediately.  When  you  issue  the  VERIFY  command  in  Command  Mode  (while 
no  exercise  is  in  progress),  IOX  includes  the  specified  device  in  its 
list  of  devices  to  exercise  but  does  not  begin  the  exercise  until  you 
start  the  exercise  with  the  START  command. 

If  no  further  parameter  commands  are  specified  within  the  VERIFY 
command  line,  the  disk  is  exercised  with  the  parameters  currently  in 
effect.  Commands  can  only  be  separated  by  spaces  or  tabs. 
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VOLUMECHECK 


VO [ LUMECHECK]  Y[ES]/N[0] 

VOLUMECHECK  is  a  device-dependent  parameter  command  that  applies  to 
NFS  disk  testing  with  SELECT.  VOLUMECHECK  enables  or  disables 
checking  of  disks  mounted  as  NFS  volumes  for  a  home  block  and  a 
Files-11  structure.  If  VOLUMECHECK  is  enabled  (VOLUMECHECK  YES) ,  then 
IOX  will  not  allow  you  to  use  the  SELECT  command  to  select  a  volume 
with  a  Files-11  structure.  With  VOLUMECHECK  disabled  (VOLUMECHECK 
NO) ,  IOX  will  allow  you  to  use  the  SELECT  command  to  select  the  disk 
without  warning  you  that  the  test  will  destroy  the  contents  of  the 
disk.  You  should  use  VOLUMECHECK  YES  unless  you  are  intentionally 
writing  over  a  Files-11  disk. 

You  can  use  the  VOLUMECHECK  command  within  the  SELECT  command  line  to 
override  the  current  default  for  the  disk  being  selected. 

The  initial  default  is  VOLUMECHECK  YES. 
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WAIT 


WA [IT]  Y[ES]/N[0] 

WAIT  is  a  general  parameter  command  you  use  to  determine  whether  or 
not  IOX  waits  for  an  event  flag  while  an  exercise  is  in  progress.  The 
WAIT  command  has  no  affect  on  tasks  that  you  initiated  with  the 
EXECUTE  command. 

WAIT  YES  requires  IOX  to  wait  for  an  event  flag  to  signal  that  an  I/O 
operation  has  completed.  During  this  time,  the  Executive  may  be  able 
to  execute  another  task. 

If  you  set  WAIT  NO,  IOX  executes  an  idle  loop  during  I/O  operations. 
Setting  WAIT  NO  can  monopolize  system  resources.  Therefore,  you 
should  not  set  WAIT  NO  unless  you  intentionally  want  to  monopolize 
system  resources. 

The  initial  default  is  WAIT  YES. 
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WRITECHECK 


WR [ ITECHECK]  Y[ES] /N[0] 

WRITECHECK  is  a  device-dependent  parameter  command  that  applies  only 
to  testing  NFS  disks  with  SELECT.  You  use  the  WRITECHECK  command  to 
determine  whether  or  not  I/O  drivers  perform  write  checks  to  NFS 

disks. 

If  WRITECHECK  is  enabled,  IOX  writes  data  to  the  disks  by  issuing  an 
IO.WLC  (write  logical  block  with  check)  to  the  driver  instead  of 
IO.WLB  (write  logical  block) .  This  means  that  the  disk  controller 
reads,  word-by-word,  a  copy  of  the  data  from  the  data  buffer  while 
simultaneously  reading  the  same  data  from  the  disk.  The  disk 
controller  compares  the  two  copies  of  the  data.  If  the  copies  do  not 

match  and  RETRIES  is  enabled,  the  driver  repeats  the  original  write 

operation  and  performs  another  write  check.  This  process  continues 
until  the  WRITECHECK  function  succeeds  or  the  retry  count  for  the 

driver  is  exceeded.  If  RETRIES  is  disabled  or  if  RETRIES  is  enabled 
but  the  retry  count  for  the  driver  is  exceeded,  then  the  driver  issues 
the  hard  error  message,  IE.WCK,  and  IOX  generates  an  error  message. 

You  can  use  the  WRITECHECK  command  within  the  SELECT  command  line  to 
override  the  current  default  for  the  device  being  selected. 

The  initial  default  is  WRITECHECK  NO. 


THE  I/O  EXERCISER  (IOX) 


4.1?  ERROR  MESSAGES 

IOX  generates  two  types  of  error  messages:  error  messages  with  device 
specifications  and  error  messages  without  device  specifications.  IOX 
displays  device  specifications  as  appropriate. 

The  format  for  an  error  message  with  a  device  specification  is: 

taskname  —  ddnn:  message 
taskname 

Name  of  the  IOX  task  that  is  currently  running.  In  the  error 
messages  that  follow,  taskname  is  always  IOX. 

ddnn 


Device  specification  text  of  the  message, 
message 

Information  specific  to  this  message. 

The  format  for  an  error  message  without  a  device  specification  is: 
taskname — message 

where  taskname  and  message  are  the  same  as  defined  in  the  previous 
format.  r 

All  error  messages  use  the  letter  "x"  to  indicate  that  IOX  substitutes 
the  appropriate  command,  task  name,  or  value  for  "x"  within  the 
message . 


4.13.1  Error  Messages  with  Device  Specifications 

The  error  messages  are  presented  in  alphabetical  order  by  the  first 
letter  following  the  device  specification. 


IOX  —  dduu:  bad  block,  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.BBE  error  code  returned  to  IOX  (bad  block 

error)  . 

User  Action:  Use  the  BADBLOCKS  command  (only  for  NFS  disks  to 
enter  the  block  number  into  the  badblocks  list. 


—  dduu:  block  number  out  of  range 

Explanation:  You  used  the  BADBLOCKS  command  to  enter  a  block 
number  in  the  badblocks  list  that  is  outside  the  range  of  blocks 
that  you  specified  with  the  RANGE  command. 
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I OX  —  dduu :  buffer  size  is  greater  than  default 

Explanation:  The  buffersize  that  you  specified  in  the  SELECT  or 
VERIFY  command  line  is  greater  than  the  current  default  set  with 
the  BUFFERSIZE  command  by  itself. 

User  Action:  Either  raise  the  default  buffersize  (using 
BUFFERSIZE  by  itself)  or  lower  the  buffersize  override  for  the 
device  (using  BUFFERSIZE  within  the  SELECT  or  VERIFY  command 
line) . 


IOX  —  dduu:  data  compare  error  at  block  xxx  (decimal)  xxx  (octal) 

Good  data:  xxxxx  bad  data:  xxxxx 

Word  position:  xxx  (decimal)  xxx  (octal) 

Buffer  contained  xx.  additional  errors 

Explanation:  IOX  found  an  error  when  comparing  the  data  read 

with  the  data  written.  This  error  message  shows  the  first  block 
number  in  which  the  error  occurred  during  the  transfer,  the  good 
and  bad  data,  the  word  position  of  the  first  error  found  in  the 
buffer,  and  the  number  of  additional  errors  found  in  the  buffer. 
Section  4.10.2.1  discusses  data  compare  error  reports  in  detail. 

User  Action:  None.  If  the  error  persists,  enter  the  block  in 
the  badblocks  list  by  using  the  BADBLOCKS  command  (for  NFS  disks 
only) . 


IOX  —  dduu:  data  overrun  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  IE. DAO  error  code  returned  to  IOX  (data  overrun) . 

The  record  size  given  was  greater  than  the  record  size  read. 
This  error  occurs  on  tape  devices  only. 

User  Action:  None. 


IOX  —  dduu:  device  type  not  specified  -  defaulting  to  'DISK' 

Explanation:  This  message  tells  you  that  you  are  adding  a  device 

to  your  test  configuration  with  the  CONFIGURE  command  that  IOX 
configures  as  a  disk  by  default. 

User  Action:  None. 


IOX  —  dduu:  did  not  respond  -  unit  now  deselected 

Explanation:  The  unit  did  not  respond  to  the  IOX  command  within 

one  minute.  The  device  may  have  been  accidentally  put  off  line 
or  a  tape  drive  may  have  lost  its  column  vacuum. 

User  Action:  Check  the  device. 
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I OX  —  dduu:  does  not  support  the  x  command 

Explanation:  The  x  command  is  incompatible  with  the  device 
specification,  dduu:. 

User  Action:  None. 


IOX  —  dduu:  duplicate  block  number 

Explanation:  The  block  number  you  entered  with  the  BADBLOCKS 

command  is  already  in  the  badblocks  list  for  the  device. 

User  Action:  None. 


IOX  dduu:  end  of  tape  detected  -  unit  now  deselected 


Explanation: 
detected) . 
marker . 


10. EOT  error  code  returned  to  IOX  (end-of-tape 
IOX  attempted  to  write  a  record  past  the  end-of-tape 


User  Action: 


This  is  an  informational  message  only. 


IOX  dduu:  error  threshold  exceeded  -  unit  now  deselected 

Explanation:  The  number  of  errors  set  with  the  ERRORLIMIT 

command  has  been  exceeded. 

User  Action:  None. 


IOX  —  dduu:  error  while  reading  home  block 

Expianafion:  when  VOLUMECHECK  is  enabled,  this  message  occurs  if 
IOX  detects  an  error  while  attempting  to  read  the  home  block  of  a 
Files-11  device. 

User  Action:  The  disk  you  selected  may  be  defective.  If  you  are 

testing  a  scratch  disk,  select  the  disk  again  with  VOLUMECHECK 
NO. 

IOX  —  dduu:  failed  to  attach 

Explanation:  IOX  could  not  attach  the  unit. 

User  Action:  The  device  may  be  mounted  or  attached  by  someone 
else.  Make  sure  you  have  allocated  and  mounted  the  device. 

For  RSX1 1M-PLUS  systems,  mount  devices  with  the  /FOREIGN  switch. 


IOX  —  dduu:  failed  to  detach 

attempting  to 
system  problem. 


Explanation:  An  error  occurred  while  IOX  was 

detach  a  unit  that  it  had  previously  attached. 

User  Action:  None.  This  is  a  possible  operating 
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I OX  —  dduu :  failed  to  open  temporary  file 

Explanation:  IOX  could  not  find  enough  free  blocks  on  the  disk 
to  open  a  temporary  file  as  large  as  the  one  you  specified  with 
the  TEMPORARYFILE  command. 

User  Action:  Specify  a  smaller  temporary  file  size  either  by 
resetting  the  default  with  the  TEMPORARYFILE  command  by  itself  or 
by  using  TEMPORARYFILE  within  the  FILES11  command  line  to 
override  the  default  TEMPORARYFILE  size  for  each  device. 

If  you  are  using  the  default  (500  blocks)  when  IOX  generates  this 
message,  then  you  need  to  make  room  on  the  disk. 


IOX  —  dduu:  fatal  hardware  error  -  unit  now  deselected 

Explanation:  IE.FHE  error  code  returned  to  IOX  (fatal  hardware 

error) . 

User  Action:  Check  the  hardware. 


IOX  —  dduu:  illegal  density 

Explanation:  The  density  that  you  specified  with  the  DENSITY 

command ,  for  the  magnetic  tape  is  illegal. 

User  Action:  Reenter  the  command,  using  a  legal  density.  See 
Section  4.12. 


IOX  —  dduu:  illegal  range 

Explanation:  The  range  of  blocks  which  you  specified  on  the 

device  to  be  tested  with  the  RANGE  command  is  out  of  bounds. 

User  Action:  Use  RANGE  with  no  qualifier  to  check  the  default 
range  on  the  device;  then  specify  a  range  within  bounds. 


IOX  —  dduu:  invalid  block  number 

Explanation:  The  block  number  that  you  entered  with  the 
BADBLOCKS  command  was  not  a  valid  block  number  for  the  device. 

User  Action:  None. 

IOX  —  dduu:  I/O  is  unsatisfied  at  timeout  -  function:  xxxx 

Explanation:  When  IOX  finishes  processing,  it  waits  five  seconds 

for  I/O  to  stop.  If  a  long  tape  has  not  finished  rewinding,  this 
message  may  occur.  The  function  that  timed  out  is  xxxx. 

User  Action:  None. 
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I OX  dduu:  I/O  request  aborted  -  unit  now  deselected 

Explanation:  IE. ABO  error  code  returned  to  IOX  (operation 

aborted) .  r 

User  Action:  None. 


^OX  dduu:  is  already  configured 

Explanation:  You  tried  to  configure  with  the  CONFIGURE  command  a 

unit  that  is  already  in  the  test  configuration. 

User  AGtionj  Use  the  CONFIGURE  command  as  a  display  command  to 
check  which  devices  are  configured. 


IOX  —  dduu:  is  already  selected 

Explanation:  You  tried  to  select  a  unit  that  has  already  been 

selected.  1 

User  Action:  Use  the  PARAMETERLIST  command  to  display 
information  on  all  units  that  are  selected. 


IOX  —  dduu:  is  not  configured 

Explanation:  You  issued  a  command  that  is  valid  only  for 

configured  devices. 

User  Action:  Use  the  CONFIGURE  command  to  configure  the  device. 


IOX  dduu:  is  not  mounted  or  allocated  for  NFS  operations 

Explanation:  You  have  selected  a  device  for  testing  with  SELECT 

or  VERIFY  that  is  not  properly  allocated  and  mounted  for  NFS 
testing . 

User  Action:  Allocate  and  mount  the  device. 

For  RSX11M-PLUS  systems,  mount  NFS  devices  with  the  /FOREIGN 
switch. 

IOX  —  dduu:  is  not  ready  -  unit  now  deselected 

Explanation:  IE.DNR  error  code  returned  to  IOX  (device  not 

ready) . 

User  Action:  Select  the  device  again. 


IOX  —  dduu:  is  not  selected 


Explanation:  You  issued  a 
(BADBLOCKS  or  RANGE)  that 
the  device. 


device-dependent  parameter  command 
is  valid  only  after  you  have  selected 


User  Action:  Select  the  device;  then  reenter  the  command. 


4-70 


THE  I/O  EXERCISER  (IOX) 


I OX  —  dduu:  is  offline 

Explanation:  IE.OFL  error  code  returned  to  IOX  (device  off 
line).  The  device  was  taken  off  line  while  testing  was  in 
progress  or  you  tried  to  select  a  device  that  was  off  line.  If 
testing  was  in  progress  on  the  device  when  it  was  taken  off  line, 
TOX  appends  "  -  unit  now  deselected"  to  the  error  message. 

User  Action:  Ensure  that  the  device  is  on  line. 


IOX  —  dduu:  is  write  locked  -  unit  now  deselected 

Explanation:  IE.WLK  error  code  returned  to  IOX  (write-lock 

error).  The  device  is  write-locked. 

User  Action:  Check  the  device  write-lock/write-enable  switch  and 
the  MCR  write-lock  status. 


IOX  —  dduu:  LUN  assignment  failure 

Explanation:  This  probably  means  that  the  device,  ddnn:,  is  not 
physically  present  in  your  system.  It  may  mean  that  you  have 
exceeded  the  number  of  devices  that  IOX  can  support.  The  default 
is  28  devices;  the  maximum  number  of  devices  is  246. 

User  Action:  If  the  device  is  not  physically  present  in  your 
system  then  take  no  action.  If  you  have  exceeded  the  number  of 
devices  that  IOX  can  support,  then  edit  the  Task  Builder  command 
file,  IOX.CMD  (see  Section  4.11),  to  allow  IOX  to  support  more 
devices . 


I ox  —  dduu:  privilege  violation  -  unit  now  deselected 

Explanation:  IE.PRI  error  code  returned  to  IOX  (privilege 
violation) .  The  device  was  not  allocated  or  it  was  mounted  by 
someone  else. 

User  Action:  Check  the  ownership  of  the  device. 


IOX  —  dduu:  specified  device  type  is  inconsistent 

Explanation:  You  tried  to  configure  device  "dduu"  as  a  tape  when 
a  "dd"  device  had  already  been  configured  as  a  disk.  The  same 
holds  true  if  "dd"  had  already  been  configured  as  a  tape  and  you 
tried  to  configure  another  "dd"  device  as  a  disk. 

User  Action:  Use  the  CONFIGURE  command  as  a  display  command  to 
check  on  the  devices  in  your  test  configuration.  Configure  the 
unit  using  a  different  device  mnemonic. 


IOX  —  dduu:  unexpected  error  #xx 

Explanation:  IOX  received  an  I/O  error  code  that  it  could  not 

process.  The  error  code  is  xx  (octal) . 

User  Action:  None. 
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IOX  —  dduu:  unexpected  request  to  queue  I/O  -  request  aborted 

Explanation:  IOX  received  an  AST  from  a  device  after  it  had 

deselected  the  device. 

User  Action:  Check  the  device. 


IOX  —  dduu:  unrecoverable  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.VER  error  code  returned  to  IOX  (unrecoverable 

error).  This  code  indicates  an  unrecoverable  error. 

User  Action:  Check  the  device  and  media. 


IOX  —  dduu:  VOLUMECHECK  failure.  Unit  contains  a  home  block 

Explanation:  The  unit  is  file-structured  because  the  device 
contains  a  home  block.  This  error  message  is  generated  by  select 
if  you  try  to  select  a  Files-11  volume  while  VOLUMECHECK  is 
enabled . 

User  Action:  IOX  destroys  information  on  devices  that  you  select 
for  exercising  with  the  SELECT  command.  If  you  want  to  destroy 
the  contents  of  the  disk,  disable  VOLUMECHECK  (VOLUMECHECK  NO) 
and  select  the  device  again. 


—  dduu:  write  check  error  at  block  xxx  (decimal)  xxx  (octal) 

Explanation:  IE.WCK  error  code  returned  to  IOX  (write  check 

error) .  The  write  check  operation  failed  at  block  xxx. 

User  Action:  None. 


4.13.2  Error  Messages  Without  Device  Specifications 

These  error  messages  are  presented  in  alphabetical  order  by  the  first 
letter  following  the  IOX  task  name. 

IOX  —  Indirect  command  file  syntax  error 

Explanation:  There  is  an  error  in  the  indirect  command  file. 

User  Action:  Check  the  indirect  command  file. 

IOX  —  Indirect  command  file  nesting  level  exceeded 

Explanation:  IOX  accepts  indirect  command  files  with  only  one 

level  of  nesting. 

User  Action:  Rewrite  the  indirect  command  file  so  that  it  does 
not  have  more  than  one  level  of  nesting. 
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IOX  —  Aborting  due  to  user  command 

Explanation:  You  aborted  IOX  by  using  the  MCR  ABORT  command. 

User  Action:  Reinvoke  IOX  if  you  want  to  continue  testing. 

IOX  —  EXECUTE  command  is  not  supported 

Explanation:  You  attempted  to  use  the  EXECUTE  command  in  a 

system  that  does  not  support  task  spawning. 

User  Action:  Do  another  SYSGEN  if  you  require  the  EXECUTE 
command  to  properly  test  your  I/O  devices. 

IOX  —  Command  input  I/O  error 

Explanation:  IOX  detected  an  error  when  it  tried  to  read  the 

command  that  you  typed  at  the  terminal. 

User  Action:  Reenter  the  command. 

IOX  -  Command  valid  only  in  Command  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 

while  an  I/O  exercise  is  in  progress. 

User  Action:  Either  abort  the  exercise  and  enter  the  command  or 
wait  until  the  exercise  has  finished  to  enter  the  command. 

IOX  —  Command  valid  only  in  Interactive  Mode 

Explanation:  You  tried  to  enter  a  command  that  cannot  be  entered 

unless  IOX  is  running. 

User  Action:  Type  START;  then  reenter  the  command. 

IOX  —  Command  not  unique 

Explanation:  The  command  abbreviation  that  you  entered  did  not 

distinguish  it  from  another  command. 

User  Action:  Reenter  the  command  by  using  a  longer  abbreviation. 


IOX  —  Failed  to  close  log  file.  F . ERR=  -x 

Explanation:  IOX  could  not  close  the  log  file  in  your  directory. 

The  FCS  error  returned  was  "-x". 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  IAS/RSX-11  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action . 
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I OX  —  Failed  to  open  indirect  command  file 

Explanation:  The  FCS  GCML  routine  failed  to  open  the  indirect 

command  file. 

User  Action:  Check  to  see  that  the  file  exists  and  that  you 
specified  the  file  correctly;  then  resubmit  the  file  to  IOX. 


IOX  —  Failed  to  open  log  file.  F . ERR=  -x 

Explanation:  IOX  could  not  open  the  log  file.  The  FCS  error 

returned  was  "-x". 

User  Action:  The  disk  may  be  write  protected  or  may  not  have 
enough  blocks. 


IOX  —  Failed  to  open  existing  log  file.  F . ERR=  -x 

Explanation:  IOX  could  not  open  a  log  file  that  already  exists 

in  your  directory.  The  FCS  error  returned  was  "-x" . 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
i-n  the  I AS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 


IOX  —  Failed  to  truncate/close  log  file.  F . ERR=  -x 

Explanation:  IOX  could  not  truncate  or  close  the  log  file.  The 

FCS  error  returned  was  n-x". 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
*n  the  I AS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action . 


IOX  —  Fatal  file  system  error.  F . ERR=  xxx  PC+2=  xxx 

Explanation:  IOX  exited  because  an  error  occurred  while  IOX  was 
trying  to  issue  a  read  or  write.  F. ERR  is  the  octal  error  code 
in  the  File  Descriptor  Block  indicating  the  kind  of  file  error. 
PC+2  is  the  octal  location  of  the  failure  in  the  IOX  code. 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
i-n  the  I AS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 


IOX  —  Fatal  system  error.  DSW=  xxx  PC+2=  xxx 

Explanation:  IOX  immediately  exits  because  a  directive  that  IOX 
issued  failed.  DSW  is  the  Directive  Status  word  in  octal.  PC+2 
is  the  octal  location  of  the  failure  in  the  IOX  code. 

User  Action:  Look  up  the  I/O  error  code  returned  to  IOX  by  FCS 
in  the  I AS/RSX-1 1  I/O  Operations  Reference  Manual  and  take  the 
appropriate  action. 
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I OX  —  Invalid  pattern  number 

Explanation:  You  tried  to  set  a  data  pattern  using  a  pattern 

number  greater  than  12.  The  valid  arguments  for  PATTERN  are  0 
through  12. 

User  Action:  Enter  a  valid  pattern  number. 


IOX  —  Invalid  task  name 

Explanation:  The  task  name  that  you  specified  with  the  EXECUTE 

command  is  invalid.  The  task  name  is  either  incorrect  or  the 
task  does  not  exist. 

User  Action:  Reenter  the  task  name  correctly  or  determine  if  the 
task  exists. 


IOX  —  No  activity  remains  -  aborting 

Explanation:  In  Execution  Mode,  IOX  determines  whether  or  not 
any  exercises  are  in  progress  or  any  tasks  are  executing  at  one 
minute  intervals.  If  IOX  finds  no  activity,  it  aborts  the 
exercise  and  generates  this  informational  message. 

In  Interactive  Mode,  IOX  determines  whether  or  not  any  exercises 
are  in  progress  or  any  tasks  are  executing  only  when  you  enter 
the  PROCEED  command.  If  there  is  no  activity  when  you  enter 
PROCEED,  IOX  aborts  the  exercise  and  issues  this  informational 
message . 

User  Action:  None. 


IOX  —  No  activity  to  start 

Explanation:  When  you  issued  the  START  command,  no  devices  were 

selected  for  testing  and  no  tasks  were  initiated  for  execution. 

User  Action:  Select  devices  that  you  want  to  test,  and  use  the 
EXECUTE  command  to  initiate  tasks  that  you  want  to  execute. 


IOX  —  No  buffer  space  available 

Explanation:  IOX  does  not  have  adequate  buffer  space  to 

accommodate  all  the  devices  you  selected. 

User  Action:  Either  deselect  some  devices  from  testing  or 

reinstall  or  reinvoke  IOX  with  a  greater  increment. 


IOX  —  No  such  command  -  type  H  for  help 

Explanation:  You  entered  a  command  that  IOX  did  not  recognize. 

User  Action:  Enter  H  (abbreviation  for  the  HELP  command) ,  which 
displays  a  summary  all  IOX  commands. 
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IOX  —  No  tasks  to  abort 


Explanation : 

when  no  tasks 


You  tried  to  abort  tasks  using  the  ABORT 
had  been  initiated  by  the  EXECUTE  command. 


command 


User  Action:  None. 


IOX  —  Only  CTRL/C  allowed 

Explanation:  You  set  CONTROL_C  YES  to  enable  you  to  enter  IOX 

commands  while  exercises  are  in  progress.  Therefore,  IOX  only 
accepts  CTRL/C  in  Execution  Mode. 

User  Action:  Enter  CTRL/C  to  exit  Execution  Mode,  then  IOX  is  in 
Interactive  Mode  and  you  can  enter  commands. 


IOX  —  Syntax  error 

Explanation:  The  command  line  that  you  entered  contained  a 

syntax  error. 

User  Action:  If  necessary,  check  the  syntax  of  the  command  line 
that  you  entered.  See  Section  4.12  or  type  H  (for  HELP). 


IOX  —  Task  never  executed 

Explanation:  The  task  that  you  tried  to  abort  is  not  on  the  list 

of  tasks  initiated  by  the  EXECUTE  command. 

User  Action:  Use  the  PARAMETERLIST  command  to  check  the  list  of 
tasks  to  be  executed. 


IOX  —  Task  "xxxxxx"  is  currently  active 

Explanation:  You  tried  to  execute  a  task  that  was  already 

active.  The  name  of  the  task  is  "xxxxxx". 

User  Action:  None. 


IOX  —  Task  "xxxxxx"  is  completed.  Status=  nnnnnnn 

Explanation:  The  task  has  completed  execution.  The  name  of  the 

task  is  "xxxxxx".  There  are  four  task  statuses  represented  by 
"nnnnnnn":  SUCCESS,  WARNING,  ERROR,  and  SEVERE  ERROR. 

User  Action:  None. 


IOX  —  Task  "xxxxxx"  is  not  installed 

Explanation:  Task  "xxxxxx"  is  not  installed  and  cannot  be 

initiated  using  the  EXECUTE  command. 

User  Action:  Install  the  task  from  a  privileged  terminal. 
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IOX 


—  Task  "xxxxxx"  is  unable  to  execute 
Explanation:  Task  "xxxxxx"  could  not  execute. 

User  Action:  Try  to  execute  the  task  again. 


IOX  —  Units  are  selected  -  command  ignored 

Explanation:  The  BUFFERSIZE  command  is  valid  only  if  no  units 

are  selected  for  testing. 

User  Action:  You  can  use  the  BUFFERSIZE  command  within  the 
SELECT  and  VERIFY  command  lines  to  override  the  default  for  each 
device.  However,  if  you  require  a  larger  BUFFERSIZE  for  all 
devices,  use  the  DESELECT  command  to  deselect  all  units;  then 
reissue  the  BUFFERSIZE  command. 
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The  Bad  Block  Replacement  Control  Task  (RCT)  handles  bad  block 
replacement  and  recovery  on  Mass  Storage  Control  Protocol  (MSCP)  disks 
such  as  the  RA80.  Bad  block  handling  on  MSCP  disks  consists  of  four 
stages:  detecting,  notifying,  replacing,  and  revectoring.  The  disk 
controller  ( UDA50 )  handles  the  detection  of  bad  blocks  and 
notification  of  the  driver  (DUDRV) .  The  driver  activates  RCT.  RCT 
performs  all  the  bad  block  replacement  functions  that  enable  the 
controller  to  revector  (redirect)  I/O  from  the  bad  block  to  the 
replacement  block . 

RCT  also  performs  replacement  and  recovery  on  MSCP  disks  that  went  off 
line  during  bad  block  replacement  or  before  the  contents  of  a 
write-back  cache  was  copied  to  the  disk. 


5.1  BAD  BLOCK  REPLACEMENT  FUNCTIONS 

RCT  performs  the  following  bad  block  replacement  functions: 

•  Stores  data  from  the  bad  block 

•  Allocates  a  replacement  block 

•  Updates  data  structures  on  the  disk 

•  Initializes  the  replacement  block 


5.2  RECOVERY  TECHNIQUES 

RCT  checks  MSCP  disks  that  have  just  come  on  line  for  two  conditions: 
incomplete  bad  block  replacement,  and  write-back  cache  corruption.  If 
RCT  determines  that  bad  block  replacement  was  partially  completed  when 
the  disk  went  off  line,  RCT  completes  the  bad  block  replacement 
process.  If  RCT  determines  that  the  write-back  cache  was  not  copied 
to  the  disk  before  the  disk  went  off  line,  RCT  software  write-locks 
the  disk  so  that  the  content  of  the  write-back  cache  is  preserved. 
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5.3  INSTALLING  RCT 

If  you  select  a  DU:  device  in  SYSGEN,  RCT...  and  DUDRV  are  both 
built.  RCT...  is  installed  and  DUDRV  is  loaded  in  SYSVMR.CMD.  You 
load  or  install  and  load  RCT...  and  DUDRV  only  if: 

•  You  have  removed  RCT...  and/or  unloaded  DUDRV. 

•  You  have  edited  SYSVMR.CMD  to  exclude  one  or  both. 

If  you  manually  install  RCT...  and  load  DUDRV,  you  must  install 
RCT...  first.  Otherwise,  you  receive  a  message  at  the  console 
terminal,  indicating  that  the  Replacement  Control  Task  is  not 
installed . 

To  install  RCT,  use  the  following  command  line: 

>INS  $RCT/TASK=RCT. . . 


5.4  DISK  CONFIGURATION  OF  MSCP  DISKS 

Three  address  spaces  on  MSCP  disks  are  relevant  to  RCT: 

•  Logical  blocks  (LBNs) 

•  Replacement  blocks  (RBNs) 

•  Revector  control  tables 


5.4.1  Logical  Blocks  (LBNs) 

Logical  blocks  (LBNs)  are  accessible  to  user  tasks  for  transferring 
data  between  the  disk  and  the  operating  system.  When  the  controller 
encounters  a  bad  LBN  and  notifies  DUDRV,  DUDRV  activates  RCT  to 
replace  the  LBN. 


5.4.2  Replacement  Blocks  (RBNs) 

Replacement  blocks  (RBNs)  are  blocks  reserved  throughout  the  disk  that 
RCT  allocates  as  substitutes  for  bad  LBNs.  RBNs  cannot  be  directly 
accessed  by  user  tasks  during  normal  data  transfers. 


5.4.3  Revector  Control  Tables 

The  revector  control  tables  are  accessible  only  by  RCT  (by  way  of 
DUDRV)  and  the  device  controller.  Each  table  entry  corresponds  to  an 
RBN  according  to  its  location  in  the  table.  An  entry  contains  the  LBN 
being  replaced  and  a  code  describing  the  status  of  the  RBN.  There  are 
five  status  codes:  ALLOCATED,  UNALLOCATED,  UNUSABLE,  PRIMARY.  and 
SECONDARY. 

For  a  given  LBN,  a  primary  RBN  is  in  a  predetermined  location,  such  as 
the  last  sector  of  the  same  track  as  the  LBN.  For  that  LBN,  all  other 
RBNs  are  secondary. 
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Sector  0  of  the  revector  control  tables  stores  information  in  a  flag 
word  that  enables  RCT  to  determine  if  recovery  techniques  are  required 
when  a  disk  is  brought  on  line. 


5.5  BAD  BLOCK  HANDLING  ON  MSCP  DISKS 

Bad  block  handling  on  MSCP  disks  consists  of  four  stages: 

•  Detection  performed  by  the  device  controller,  UDA50 

•  Notification  performed  by  the  controller  which  notifies  the 
driver,  DUDRV 

•  Replacement  performed  by  RCT 

•  Revectoring  performed  dynamically  by  the  device  controller 


5.5.1  Bad  Block  Detection 

The  UDA50  controller  may  detect  a  bad  LBN  while  processing  an  I/O 
request  from  the  driver. 


5.5.2  Bad  Block  Notification 

When  the  UDA50  controller  detects  a  bad  LBN,  it  notifies  DUDRV  by 
listing  the  bad  LBN  in  an  end  packet.  DUDRV  stores  this  information 
in  pool  and  activates  RCT. 

DUDRV  provides  RCT  with  the  information  necessary  to  perform  bad  block 
replacement : 

•  LBN 

•  I/O  packet  address 

•  Unit  Control  Block  (UCB)  address 


5.5.3  Bad  Block  Replacement 

RCT  performs  the  following  steps  in  bad  block  replacement: 


1.  Emulates  an  ATTACH  to  the  disk,  inhibiting  all  I/O  other  than 
I/O  necessary  for  bad  block  replacement. 


2. 

Reads  the  data  from  the  bad  LBN  into 
space . 

a  buffer  in 

i  its 

data 

3. 

Determines  which  RBN  on  the  disk 
predetermined  algorithm. 

to  use  by 

applying  a 

4. 

Issues  QIOs  to  DUDRV  that  update  the 
(discussed  in  Section  5.4.3). 

revector  cont 

rol 

tables 
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5.  Updates  the  header  and  data  of  the  bad  LBN  by  issuing  an 

IO.RPL  to  DUDRV •  This  I/O  function  code  directs  the 

controller  to  indicate  in  the  header  of  the  LBN  that  the  LBN 
has  been  replaced  either  by  a  primary  or  secondary  RBN  and 
writes  128  copies  of  the  address  of  the  RBN  in  the  data  field 
of  the  LBN. 

6.  Initializes  the  RBN  by  writing  the  data  read  from  the  LBN 
back  to  the  bad  LBN.  Since  the  bad  LBN  has  been  replaced  by 
the  RBN ,  the  data  is  transparently  written  to  the  RBN  by  the 
controller . 

If  an  RBN  is  bad,  RCT  treats  it  as  a  bad  LBN.  RCT  finds 
another  RBN,  updates  the  revector  control  tables,  marks  the 
old  RBN  as  unusable,  and  initializes  the  new  RBN  by  writing 
the  stored  data  back  to  the  bad  LBN. 

7.  RCT  detaches  the  unit,  and  normal  I/O  to  the  disk  resumes. 


5.5.4  Bad  Block  Revectoring 

Revectoring  is  performed  dynamically  by  the  device  controller.  When 
the  controller  first  accesses  an  LBN  that  has  been  replaced  by  RCT, 
the  controller  revectors  (redirects)  the  I/O  to  the  RBN  that  RCT 
designated  as  the  replacement  for  the  LBN.  Thereafter,  I/O  to  the  bad 
LBN  is  transparently  revectored  to  the  RBN  without  DUDRV' s  activating 
RCT. 


5. 5.4.1  Primary  RBNs  -  When 
header  indicates  that  it 
controller  directly  accesses 


the  controller  detects  a 
has  been  replaced  by  a 
the  RBN. 


bad  LBN  whose 
primary  RBN,  the 


5. 5. 4. 2  Secondary  RBNs  -  When  the  controller  detects  a  bad  LBN  whose 
header  indicates  that  it  has  been  replaced  by  a  secondary  RBN,  the 
controller  must  look  up  the  address  of  the  RBN  before  it  can  access 
the  RBN.  The  controller  finds  the  address  of  the  secondary  RBN  in  one 
of  two  ways: 

1.  Checking  the  data  field  of  the  bad  LBN,  which  contains  the 
128  copies  of  the  RBN 

2.  Checking  the  revector  control  tables  for  the  entry  containing 
the  bad  LBN 


5.6  COMPLETING  PARTIAL  BAD  BLOCK  REPLACEMENTS 

When  a  disk  unit  is  brought  on  line,  RCT  checks  that  no  bad  block 
replacement  was  in  progress  when  the  disk  went  off  line  by  checking 
the  flag  word  in  sector  0  of  the  revector  control  table.  If 
replacement  needs  to  be  completed,  RCT  completes  the  bad  block 
replacement. 
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5.7  PREVENTING  LOSS  OF  WRITE-BACK  CACHE  DATA 
RCT  prevents  loss  of  write-back  cache  data. 

A  disk  with  the  write-back-cache-in-use  flag  set  will  be  write-locked 
each  time  it  is  brought  on  line.  To  write-enable  such  a  disk,  use  the 
/WRITE  qualifier  with  the  MCR  MOUNT  command  each  time  you  mount  the 
disk.  RCT  checks  the  write-back-cache-in-use  flag  word  in  sector  0  of 
the  revector  control  tables,  software  write-locks  the  disk  if  the  flag 
is  set,  and  writes  the  following  TKTN  message  to  the  console  output 
device  (CO: ) : 

ddnn:  —  Write  back  caching  data  lost.  Unit  write  locked 
where  ddnn:  is  the  disk  that  RCT  has  write  locked. 


NOTE 

Because  RSX-11M  and  RSX-11M-PLUS 
operating  systems  do  not  support  disks 
with  write-back  caching,  this  function 
is  extremely  rare. 


RCT  performs  this  function  only  under  the  following  circumstances: 

1.  A  disk  with  a  write-back  cache  failed  to  copy  the  data  from 
the  write-back  cache  to  the  disk  before  going  off  line,  while 
on  another  operating  system  (that  supports  write-back 
caching) ,  and  was  then  moved  to  an  RSX-11M  or  RSX-11M-PLUS 
operating  system. 

2.  The  revector  control  tables  have  been  altered  such  that  the 
write-back-cache-in-use  flag  is  set. 


5.8  RCT  AND  OTHER  RSX11M/M-PLUS  UTILITIES 

Utilities  such  as  BAD,  BRU,  and  INI  treat  MSCP  devices  as 
non-last-track  devices.  RCT  does  not  replace  the  BAD  utility.  You 
must  run  BAD  on  MSCP  devices  to  create  a  bad  block  descriptor  file 
before  you  initialize  the  disk.  You  can  use  BAD  to  find  bad  blocks 
and  list  them  in  a  bad  block  descriptor  file.  However,  the  bad  block 
descriptor  file  will  not  contain  any  information  about  blocks  detected 
by  the  device  controller  and  replaced  by  RCT. 


5.9  RCT  AND  THE  ERROR  LOGGER 

DUDRV  notifies  the  Error  Logger  with  an  error  log  packet  whenever  an 
error  has  been  detected  that  requires  bad  block  replacement.  RCT  also 
generates  an  error  log  packet  indicating  that  a  bad  LBN  has  been 
successfully  (or  unsuccessfully)  replaced  by  an  RBN .  RCT  logs  the 
packet  under  the  name  of  the  task  that  issued  the  QIO  resulting  in  the 
detection  of  the  bad  block  by  the  controller. 


5-5 


CHAPTER  6 


RESOURCE  MONITORING  DISPLAY  (RMD) 


The  Resource  Monitoring  Display  (RMD)  is  a  privileged  task  that 
displays  information  about  the  resources  in  your  system.  This 
information  includes  the  active  tasks,  their  location  in  memory,  the 
amount  of  memory  they  occupy,  and  available  pool  space.  On  video 
terminals  such  as  VT52s  and  VTlOOs,  RMD  provides  dynamic  displays.  On 
hardcopy  terminals  such  as  LA180s,  RMD  provides  "snapshot"  displays. 
RMD  alters  the  display  format  according  to  terminal  type  without  your 
having  to  set  switches  or  rebuild  the  task. 


5.1  INTRODUCTION 

RMD  consists  of  "pages".  A  page  consists  of  24  lines,  which,  on  CRT 
terminals,  is  one  screen.  The  program  contains  two  kinds  of  pages: 
display  pages  and  setup  pages. 


6.1.1  Display  Pages 

There  are  four  display  pages: 

•  Memory  (M) 

•  Active  Task  List  (A) 

•  Task  Header  (T) 

•  Help  (H) 

You  press  the  terminal  keys  indicated  in  parentheses  to  switch  display 
pages. 


6.1.2  Setup  Pages 

There  are  three  setup  pages.  Each  setup  page  is  associated  with  a 
display  page.  (The  Help  Display  Page  has  no  associated  setup  page.) 
You  access  a  setup  page  from  a  display  page  by  pressing  the  ESCAPE  key 
on  your  terminal.  The  setup  page  documents  and  prompts  you  for  setup 
commands,  which  alter  the  content  of  the  information  displayed  on  the 
associated  display  page. 


6-1 


RESOURCE  MONITORING  DISPLAY  (RMD) 


6.2  INSTALLING  AND  INVOKING  RMD 

Individual  users  can  invoke  RMD  at  their  terminals.  For  large  systems 
that  support  many  terminals,  you  may  want  to  run  RMD  continuously  on  a 
slaved  terminal  near  the  computer.  You  use  different  procedures  to 
install  and  invoke  RMD  for  use  by  individual  users  and  to  run  RMD  on  a 
slaved  terminal. 


6.2.1  Using  RMD  at  Individual  Terminals 

On  RSX-11M  systems,  RMD  is  installed  if  you  selected  RMD  at  system 
generation. 

On  RSX-1 1M-PLUS ,  RMD  is  installed. 


6. 2. 1.1  Installing  RMD  for  Use  at  Individual  Terminals  -  You  must 
install  RMD  if  you  have  removed  it.  To  install  RMD,  use  the  MCR 
INSTALL  command  at  a  privileged  terminal: 

> INS  $RMD 


6. 2. 1.2  Invoking  RMD  for  Use 
terminal,  you  invoke  an  installed 

>RMD  [page] [ , setupcommand]  . 


at  Individual  Terminals  -  From  any 
copy  of  RMD  from  MCR  as  follows: 


page 


One  of  the  display  page  abbreviations  (M,  A,  T,  or  H) .  The 
default  page  is  the  Memory  Display  (M) . 

setupcommand 

A  valid  setup  command  for  the  display  page  that  you  have 
selected.  The  setup  commands  are  the  same  as  those  available  to 
you  from  the  setup  page  associated  with  the  display  page  you 
specified.  The  default  setup  commands  are  discussed  in  Sections 
6.4  through  6.6,  which  describe  the  content  of  each  display  page 
and  how  you  use  setup  commands  to  alter  display  parameters. 

From  a  privileged  terminal  only,  you  can  invoke  an  uninstalled  copy  of 
RMD  using  the  MCR  RUN  command.  However,  MCR  command  line  parsing  is 
available  only  if  RMD  is  installed. 


6.2.2  Running  RMD  on  a  Slaved  Terminal 

To  run  RMD  on  a  slaved  terminal  and  also  allow  users  to  invoke  RMD  at 
their  own  terminals,  RMD  must  be  installed  twice  using  different  task 
image  files  and  different  task  names. 

On  RSX-11M  systems,  if  you  selected  RMD  at  system  generation,  you  will 
find  RMD. TSK ,  which  has  been  task  built  at  system  generation  with  task 
name  ...RMD,  in  SYSUIC  on  your  system  disk. 
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c 

C 


On  RSX-1 1M-PLUS  systems,  you  will  find  RMD.TSK,  which  has  been  task 
built  at  system  generation  with  task  name  ♦.•RMD,  in  SYSUIC  on  your 
system  disk. 

RMD.TSK  is  the  copy  of  RMD  that  the  system  installs  for  individual 
users  to  invoke.  LUNs  1  and  2  in  this  task  image  have  been  assigned 
to  TIs  so  that  a  user  at  any  terminal  can  invoke  RMD. 

To  run  RMD  on  a  slaved  terminal,  do  the  following: 

1.  From  a  privileged  terminal,  make  a  copy  of  RMD.TSK  in  SYSUIC 
on  your  system  disk  named  RMDEMO.TSK.  If  your  SYSUIC  is 
[1,54]  and  your  system  disk  is  DRO:,  use  the  following 
command  sequence: 

> SET  /UIC= [1,54] 

> ASN  DRO : =SY : 

>PIP  RMDEMO • TSK=RMD • TSK 

2.  Either  from  a  privileged  terminal  or  from  a  command  file  to 
be  executed  at  a  privileged  terminal,  install  RMDEMO  using 
the  following  command  sequence: 

> INS  RMDEMO/TASK=RMDEMO 
>REA  RMDEMO  1  ttnn: 

>REA  RMDEMO  2  ttnn: 

>SET  /SLAVE=ttnn : 

>RUN  RMDEMO 

where  ttnn:  is  the  terminal  at  which  you  want  to  run  RMD. 

This  command  sequence  installs  RMD  with  task  name  RMDEMO, 
reassigns  LUNs  1  and  2  to  the  terminal  you  want  to  slave  to 
the  task,  slaves  the  terminal,  and  invokes  the  task. 

Because  the  REASSIGN  command  alters  the  task  image  on  disk, 
you  must  use  two  task  images  rather  than  simply  installing 
RMD  twice  with  different  task  names. 


6.3  THE  HELP  DISPLAY 


The  Help  Display  documents  how  you  switch  display  pages, 
display  pages  by  pressing  a  terminal  key  as  follows: 


You  switch 


Key 


Explanation 


M  Accesses  the  Memory  Display 

A  Accesses  the  Active  Task  Display 

T  Accesses  the  Task  Header  Display 


The  Help  Display  also  documents  how  to  exit  from  RMD  to  MCR  and  use 
the  ESCAPE  key  to  access  setup  pages  from  their  associated  display 
pages.  (Because  there  is  nothing  to  alter  on  the  Help  Display,  no 
setup  page  is  available  from  the  Help  Display.) 

The  Memory,  Active  Task,  and  Task  Header  Displays  use  the  entire 
screen.  Therefore,  you  receive  no  prompts  or  documentation  on  display 
pages.  To  find  out  how  to  access  a  setup  page  from  a  display  page  or 
how  to  switch  display  pages,  press  the  H  key  (for  Help)  to  access  the 
Help  Display. 
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6.4  THE  MEMORY  DISPLAY 

The  Memory  Display  graphically  represents  the  entire  system  memory, 
including  the  approximate  size  and  locations  of  partitions  and  active 
tasks.  The  display  also  shows  pool  statistics,  the  name  of  the  task 
that  is  currently  executing,  and  other  information  about  the  status  of 
your  operating  system.  You  access  the  Memory  Display  from  another 
display  page  by  pressing  the  M  key  (for  Memory).  To  access  the  Memory 
Display  from  the  MCR  command  line,  you  type: 

>RMD  M 

If  you  invoke  RMD  without  specifying  a  display  page: 

>RMD 

RMD  defaults  to  the  Memory  Display. 

Figures  6-1  and  6-2  show  "snapshots"  of  the  Memory  Display  for  RSX-11M 
and  RSX-11M-PLUS  respectively.  The  reverse  numbers  in  each  figure 
(white  numbers  in  black  circles)  match  the 
explanations  that  follow  the  two  figures 
the  same  for  both  RSX-11M  and  RSX-1 1M-PLUS , 
same  reverse  number  in  Figures  6-1  and  6-2. 
however,  appears  only  once. 


reverse  numbers  in  the 
Where  a  display  field  is 
it  is  designated  by  the 
The  matching  explanation. 
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Figure  6-1  RSX-11M  Memory  Display 
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Figure  6-2  RSX-11M-PLUS  Memory  Display 


Q  Operating  system  type ,  version  number ,  and  base  level. 

0  Six-character  name  that  is  a  DECnet  node  name  (if  DECnet  is 
running  on  your  system)  or  the  system  name  that  you  selected  in 
SYSGEN  (if  DECnet  is  not  running  on  your  system). 

0  Size  in  K  words  of  the  system  memory. 

O  For  RSX-1 1M-PLUS  systems,  time  elapsed  in  units  of  days,  hours, 
and  minutes,  since  the  system  was  last  booted. 

0  Current  date  and  time. 

0  Name  of  the  task  that  is  currently  executing  or,  if  none  is 
executing,  *IDLE*  (Executive  executing  the  idle  loop). 

0  Number  of  free  blocks  on  the  first  four  Files-11  devices  in  your 
system.  If  a  device  is  dismounted,  RMD  displays:  "DMO" •  If  a 
device  is  off  line,  RMD  displays:  "OFL". 


6-5 


RESOURCE  MONITORING  DISPLAY  (RMD) 


6 . 4 . 1 . 1 
Files-11 
available 
and  6-2. 
Files-11 


The  FREE  Command  -  You  use  this  command  to  determine  the  four 
devices  for  which  you  want  the  Memory  Display  to  show  the 
free  blocks.  This  information  is  (7)  in  both  Figures  6-1 
The  default  is  your  system  disk  (SY:)  and  the  next  three 
devices  in  your  configuration. 


6.4.1. 2  The  RATE  Command  -  You  use  this  command  to  determine  how 
RMD  replots  the  Memory  Display  if  you  are  running  RMD  on  a  CRT. 
The  default  replot  rate  is  once  per  second. 


6.4.2  Altering  the  Memory  Display  from  the  MCR  Command  Line 

You  can  enter  the  FREE  and  RATE  commands  as  part  of  the  MCR  command 
line.  (The  general  format  of  the  MCR  command  line  is  discussed  in 
Section  6. 2. 1.2.)  For  example,  when  you  enter  the  MCR  command  line 

>RMD  M,FREE3=DM0: ,RATE=3 


RMD  displays  the  number  of  free  blocks  on  DM0:  instead  of  the  fourth 
Files-11  device  in  your  configuration  and  replots  the  display  every 
three  seconds  instead  of  every  second. 

To  change  the  second  and  third  Files-11  devices  to  DB1:  and  DB2- 

respectively,  use  the  MCR  command  line: 

>RMD  M , FREE1=DB1 : , FREE2=DB2  : 


These  setup  parameters  stay  in  effect  until  you  alter  them  by  usinq 
setup  commands  from  the  setup  page.  Even  if  you  switch  to  another 
display  page  and  back  to  the  Memory  Display,  RMD  does  not  restore  the 
default  setup  parameters. 


6.5  THE  ACTIVE  TASK  DISPLAY 


3^^oetlZK-TaSj-Dlfplay  shows  y°u  the  active  tasks  in  the  system.  You 
®  . .  1S_  dlfPlay  from  another  display  page  by  pressing  the  A  key 

you  type- Ve  TaSk) *  T°  access  thls  display  from  the  MCR  command  line. 


>RMD  A 

This  display  has  six  fields: 
•  Name  of  the  task 


•  Length  of  the  task  in  octal  bytes 

•  Terminal  that  issued  the  task 

•  Running  priority  of  the  task 

•  Outstanding  I/O  count 

•  Status  flags 
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6.5.1  Altering  the  Active  Task  Display  from  the  Setup  Page 

To  alter  the  Active  Task  Display,  you  press  the  ESCAPE  key,  which 
displays  the  setup  page  for  the  Active  Task  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  you  use  to  alter  the 
Active  Task  Display.  You  can  enter  multiple  commands  after  each 
prompt  by  using  commas  as  separators.  The  setup  commands  available 
for  altering  the  Active  Task  Display  are: 

•  OWNER=ttnn:  where  ttnn:  is  the  terminal  that  issued  the  task 

•  PRIORITY=p  where  p  is  a  task's  running  priority 

•  RATE=s  where  s  is  the  replot  rate  in  seconds 

•  TASK=taskname  where  taskname  is  the  name  of  the  task  whose 
header  you  want  to  display 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  stay  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Active  Task  Display. 


6. 5. 1.1  The  OWNER  Command  -  This  command  allows  RMD  to  display  only 
those  tasks  that  have  been  issued  by  a  particular  terminal.  The 
default  is  ALL,  which  displays  tasks  issued  from  all  terminals. 


6. 5. 1.2  The  PRIORITY  Command  -  The  active  task  list  may  be  too  long 
to  fit  on  one  screen.  You  use  the  PRIORITY  command  to  determine  the 
highest  priority  tasks  that  you  want  to  see.  The  default  is  250,  the 
highest  possible  priority. 


6. 5. 1.3  The  RATE  Command  -  This  command  allows  you  to  determine  how 
often  RMD  replots  the  Active  Task  Display,  if  you  are  running  RMD  on  a 
CRT.  The  default  replot  rate  is  once  per  second. 


6. 5. 1.4  The  TASK  Command  -  This  command  allows  you  to  look  at  a 
specific  task  header.  This  command  is  an  exception  because  it  is  the 
only  setup  command  that  switches  display  pages.  There  is  no  default 
for  the  TASK  command.  The  Task  Header  Display  is  discussed  in  Section 

6.6. 


6.5.2  Altering  the  Active  Task  Display  from  the  MCR  Command  Line 

You  can  enter  the  same  setup  commands  discussed  in  the  previous 
section  as  part  of  the  MCR  command  line.  For  example,  when  you  enter 
the  MCR  command  line: 

>RMD  A , PRIORITY=2  00 , RATE  =  3 

RMD  displays  the  Active  Task  Display  using  200  as  the  maximum  task 
priority  and  replots  the  display  every  three  seconds. 

To  display  only  those  tasks  issued  by  your  terminal,  type: 

>RMD  A, OWNER=TI : 
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6.6  THE  TASK  HEADER  DISPLAY 

The  Task  Header  Display  shows  you  the  task  header  of  the  task  you 
specify.  You  access  this  display  from  another  display  page  by 
pressing  the  T  key  (for  Task  Header) .  If  no  task  is  currently 
specified,  RMD  shows  you  the  setup  page  first  so  that  you  can  specify 
the  task  whose  task  header  you  want  RMD  to  display. 

To  access  the  Task  Header  Display  from  the  MCR  command  line,  you  type: 
>RMD  T, TASK=taskname 

where  taskname  is  the  name  of  the  task  whose  header  you  want  RMD  to 
display. 

If  you  invoke  RMD  from  the  MCR  command  line  without  specifying  the 
name  of  a  task: 

>RMD  T 

RMD  displays  the  setup  page  first  so  that  you  can  specify  the  name  of 
the  task  whose  header  you  want  RMD  to  display. 

The  Task  Header  Display  shows  you  the  following  information  about  the 
specified  task: 

•  Name  of  the  task 

•  Name  of  the  partition  in  which  the  task  runs 

•  Status  flags,  which  have  the  same  mnemonics  as  in  the  Active 
Task  display 

•  Owner  of  the  task  by  terminal  number 

•  Outstanding  I/O  count 

•  Default  priority 

•  Running  priority 

•  Swapping  priority 

•  Length  in  decimal  words 

•  Contents  of  the  six  general  purpose  registers,  the  program 
counter,  and  the  Processor  Status  Word 

•  Contents  of  the  Directive  Status  Word  ($DSW) 

•  Local  event  flags 

•  Logical  unit  number  (LUN)  assignments  to  a  maximum  of  24  LUNs 


6.6.1  Altering  the  Task  Header  Display  from  the  Setup  Page 

To  alter  the  Task  Header  Display,  you  press  the  ESCAPE  key,  which 
displays  the  setup  page  for  the  Task  Header  Display.  The  setup  page 
documents  and  prompts  you  for  commands  that  alter  the  Task  Header 
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Display.  You  can  enter  multiple  commands  after  each  prompt  by  using 
commas  as  separators.  The  setup  commands  available  for  altering  the 
Task  Header  Display  are: 

•  RATE=s  where  s  is  the  replot  rate  in  seconds 

•  TASK=taskname  where  taskname  is  the  name  of  the  task  whose 
header  you  want  to  display 

You  can  truncate  these  commands  to  their  shortest  unique  forms.  These 
setup  parameters  remain  in  effect  until  you  alter  them,  even  if  you 
switch  to  another  display  page  and  back  to  the  Task  Header  Display. 


6. 6. 1.1  The  RATE  Command  -  This  command  allows  you  to  determine  how 
often  RMD  replots  the  Task  Header  Display  if  you  are  running  RMD  on  a 
CRT.  The  default  replot  rate  is  once  per  second. 


6.6. 1.2  The  TASK  Command  -  This  command  changes  the  task  header  to  be 
displayed.  There  is  no  default.  The  TASK  command  has  the  same 
function  as  the  TASK  command  on  the  Active  Task  Display,  except  that 
here  it  does  not  switch  display  pages. 


6.6.2  Altering  the  Task  Header  Display  from  the  MCR  Command  Line 

Both  the  RATE  and  TASK  commands  are  available  to  you  from  the  MCR 
command  line.  If  you  invoke  RMD  using  the  following  command  line: 

>RMD  T , RATE=2 , TASK= • • . EDT 

RMD  displays  the  Task  Header  Display  for  EDT,  replotting  the  page 
every  two  seconds.  You  must  give  the  full  task  name.  In  this  case 
the  taskname  is  "...EDT",  not  "EDT”. 

If  you  do  not  specify  a  task  name  in  the  MCR  command  line: 

>RMD  T, RATE=2 

RMD  first  displays  the  setup  page  so  that  you  can  select  a  task  whose 
header  you  want  RMD  to  display.  The  replot  rate  will  be  set  to  two 
seconds . 


6.7  RSX-11M-PLUS  ONLY  DISPLAYS 

Two  displays  are  available  only  on  RSX-11M-PLUS  systems.  These  are 
the  Errorlog  Count  Display  and  the  System  Statistics  Display.  These 
displays  are  invoked  by  two  commands:  the  RMD  E  and  RMD  S  commands. 
The  setup  page  documents  and  prompts  you  for  these  two  commands.  You 
can  also  use  both  of  these  commands  as  part  of  the  MCR  command  line. 
These  commands  are  discussed  next. 
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6.7.1  The  Errorlog  Count  Display 

You  access  this  display  from  another  display  page  by  pressing  the  E 
key  (for  Errorlog  Count).  To  display  this  page  from  the  MCR  command 
line,  you  type: 

>RMD  E 


This  display  has  the  following  fields: 

•  Device  for  which  Error  Logging  is  enabled 

•  Hardware  error  count  and  hardware  error  count  limit 

•  Software  error  count  and  software  error  count  limit 

•  QIO  count 

You  access  the  setup  page  by  pressing  the  ESCAPE  key,  which  allows  you 

to  change  the  replot  rate  and  choose  a  starting  point  in  the  device 

list  (which  you  may  want  to  do  if  Error  Logging  is  enabled  for  more 
than  24  devices) . 


6.7.2  The  System  Statistics  Display 

This  display  is  available  only  if  Resource  Accounting  is  running  on 
your  RSX-1 1M-PLUS  system.  You  access  this  display  from  any  other 
display  page  by  pressing  the  S  key  (for  System  Statistics).  To 
display  this  page  from  the  MCR  command  line,  you  type: 

>  RMD  S 

This  display  includes  statistics  such  as  current  number  of  users, 
total  number  of  tasks  run,  number  of  directives  and  QIOs  issued,  and 
number  of  checkpoints.  These  statistics  are  all  measured  from  the 
time  Resource  Accounting  was  started. 

You  access  the  setup  page  by  pressing  the  ESCAPE  key,  which  allows  you 
to  change  the  replot  rate.  You  can  also  use  this  command  as  part  of 
the  MCR  command  line. 


6.8  MODIFYING  THE  TASK-BUILD  COMMAND  FILE 

You  can  modify  the  task-build  command  file  to  change  the  defaults  for 
RMD. 

On  RSX-11M  systems,  this  file  is  LB : [ 1 , 24] RMDBLD. CMD  for  mapped 
systems  and  LB :[ 1 , 20] RMDBLD. CMD  for  unmapped  systems. 

On  RSX-1 1M-P LUS  systems,  this  file  is  LB :[ 1 , 24] RMDBLD. CMD. 
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6.9  ERROR  MESSAGES 

RMD  generates  the  following  error  messages: 

RMD  -  Allocated  screen  buffer  too  small  for  this  device 

Explanation:  RMD  requires  more  internal  memory  to  display  tne 

requested  display  on  the  type  of  terminal  on  which  you  are 
running  RMD. 

User  Action:  Rebuild  RMD  with  a  larger  screen  buffer  by 
modifying  the  task-build  command  file  as  discussed  in  Section 

6.8. 


RMD  -  Illegal  command  -  xxxxx 

Explanation:  You  entered  an  illegal  command  xxxxx  either  on  the 

MCR  command  line  or  in  response  to  the  COMMAND>  prompt  on  a  setup 
page. 

User  Action:  Enter  the  correct  command  as  documented  in  this 
chapter . 


RMD  -  Page  does  not  exist 

Explanation:  You  requested  a  display  page  from  the  MCR  command 

line  that  does  not  exist. 

User  Action:  Enter  the  command  line  again  specifying  a  correct 
display  mnemonic. 


RMD  -  Segment  'xxxxxx'  not  found 

Explanation:  The  module  xxxxxx  was  not  found  in  the  task  image 

for  RMD.  This  denotes  an  error  in  how  RMD  was  task-built. 

User  Action:  Check  that  RMD  has  been  built  with  all  the  required 
modules . 


RMD  -  Terminal  type  not  defined 

Explanation:  The  operating  system  and  RMD  do  not  recognize  your 

terminal  type. 

User  Action:  Check  your  terminal  type  using  the  MCR  command 
SET  /TERM=TI : •  If  this  setting  is  incorrect,  use  the  MCR  SET 
command  to  correct  your  terminal  type  setting.  If  the  setting  is 
correct,  move  to  a  different  type  of  terminal. 
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RMD  -  Terminal  type  not  set 

Explanation:  You  did  not  build  RMD  to  display  the  requested 
display  page  on  the  type  of  terminal  to  which  your  terminal  is 
set. 

User  Action:  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TERM=TI:  command.  If  this  setting  is  incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  setting  is  correct,  move  to  a  different  type  of  terminal. 

RMD  -  Terminal  type  not  yet  supported 

Explanation:  RMD  does  not  recognize  your  terminal  type. 

User  Action:  Determine  your  terminal  type  setting  using  the 
MCR  SET  /TERM=TI :  command.  If  this  setting  is  incorrect,  use 
the  MCR  SET  command  to  correct  your  terminal  type  setting.  If 
the  terminal  type  is  correct,  you  can  write  a  terminal 
characteristics  module  for  the  terminal  similar  to  the  one  in 
[14, 10] V52CHA.MAC.  Then  assemble  the  module,  include  the  new 
module  in  the  ODL  file  and  rebuild  RMD. 
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SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


This  chapter  is  directed  to  the  system  manager  or  operator  who  will  be 
setting  up  and  running  the  Queue  Manager  and  batch  processors  on  an 
RSX-11M  or  RSX-1 1M-PLUS  system.  Except  where  noted,  all  commands  in 
this  chapter  are  privileged. 

Most  RSX-1 1M/M- PLUS  systems  will  include  the  Queue  Manager  for  the 
convenience  of  multistream  line  printer  spooling. 

The  Queue  Manager  on  RSX-11M-PLUS  also  supports  transparent  spooling 
and  batch  processing.  You  can  have  the  Queue  Manager  without  batch 
processing,  but  you  cannot  have  batch  processing  without  the  Queue 
Manager . 

In  UFD  [1,2]  on  the  system  disk  (LB:),  you  will  find  the  file 
STARTUP.CMD.  This  file  includes  commands  for  setting  up  the  Queue 
Manager  on  a  standard  configuration.  This  sets  up  the  QMG  subsystem 
on  a  baseline  system  with  one  print  processor,  and,  on  RSX-11M-PLUS 
systems,  one  batch  processor.  The  information  in  the  present  chapter 
will  help  you  alter  STARTUP.CMD  to  set  up  a  Queue  Manager  tailored  to 
your  installation. 

This  chapter  consists  of  a  narrative  introduction  and  review  of  the 
process  of  setting  up  the  Queue  Manager  and  batch  processors  and 
detailed  descriptions  of  all  commands  to  the  Queue  Manager. 

The  queue  management  subsystem  consists  of  three  major  components  on 
RSX-1 1M .  RSX-1 1M-PL US  systems  have  a  fourth  major  component.  Here 
are  the  components: 

A  command  line  interpreter  (QMGCLI)  that  processes  both  print  requests 
and  queue  access  commands  as  described  in  the  RSX-1 1 M/M- PLUS  Batch  and 
Queue  Operations  Manual.  QMGCLI  communicates  with  the  Queue  Manager 
by  sending  data  packets  to  it. 

The  Queue  Manager  (QMG)  that  controls  the  queueing  and  dequeueing  of 
print  jobs.  QMG  communicates  with  QMGCLI  and  the  despooler  tasks  to 
process  print  jobs. 

The  despool  prototype  task  (LPP)  that  attaches  a  device  and  despools 
print  jobs  to  it.  An  LPP  must  be  installed  for  each  device  to  be  used 
as  a  spool  device  with  the  task  name  ddn,  where  dd  is  the  generic 
device  name  and  n  is  the  unit  number.  A  despool  device  is  a  device 
under  the  control  of  QMG. 


On  RSX-1 1M-PLUS  systems  only,  QMG  also  controls  batch  processing.  The 
RSX-1 1M- PLUS  QMGCLI  accepts  batch  requests  as  well  as  print  requests. 
The  RSX-1 1M -PLUS  QMG  controls  the  queueing  and  dequeueing  of  batch 
jobs.  The  RSX-11M-PLUS  QMG  also  includes  a  batch  processor  prototype 
task,  BPR.  This  task  creates  a  virtual  terminal  that  passes  commands 
to  the  batch  processor  and  to  a  system  CLI,  either  MCR  or  DCL,  or  a 
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user-written  CLI.  (Note  that  QMGCLI  is  not  a  CLI  in  this  sense.)  The 
BPR  task  can  be  installed  as  many  as  16  times  with  task  names  in  the 
form  BAPnnn ,  where  nnn  represents  one  to  three  Radix-50  characters. 

On.RSX-llM-PLUS  only,  the  source  files  in  SYO: [121,10]  make  up  the 
print  processor  task.  You  can  use  this  as  a  model  if  you  wish  to 
write  output  despoolers  for  your  applications. 


7.1  INTRODUCTION  AND  REVIEW 


The  following  narrative  explains  how  to  bring  QMG  into  your  system. 
Both  MCR  and  DCL  commands  are  included. 


This  can  be  done  interactively,  but  in  most  cases  you  will  include  it 
in  an  indirect  command  file  invoked  as  part  of  the  system's  STARTUP 
procedures . 


NOTE 

On  RSX-1 1M-PLUS  systems  with  DCL  as  a 
CLI,  the  DCL  form  of  these  commands  can 
be . used  on  both  MCR  and  DCL  terminals. 
This  is  for  compatibility  with 
RSX-11M-PLUS  VI. 0. 


Each  of  the  following  steps  includes  a  block  diagram  of  the  Queue 
Manager,  processors,  and  devices  as  they  exist  at  that  point  in  the 
procedure.  Those  parts  of  the  subsystem  brought  into  being  by  that 
step  are  shown  in  red. 

1.  Install  the  Queue  Manager.  It  will  be  found  with  the 
privileged  utility  tasks. 


DCL>lNSTALL/CHECKPOINT  $QMG 
MCR> INSTALL  $QMG/CKP=YES 


QUEUE 

MANAGER 

stopped 


LPO: 

unspooled 


PRINTS 

.PRINT 


FCS 


>  PRINT 

ZK-154-81 
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2. 


Start  QMG .  The  command  starts  the  Queue  Manager  and 
initialize  the  default  queues  PRINT  and  BATCH.  It  creates 
the  queue  file  on  LBO:  if  the  file  is  not  there.  The 
command  also  clears  all  assignments  previously  recorded.  If 
the  queue  file  was  intact,  all  queues  will  still  contain 
their  jobs,  but  are  not  assigned  to  processors.  (Processors 
will  have  to  be  reinitialized,  but  queues  will  not.) 


DC L>START/ QUEUE/MANAGER 
MCR>QUE  /STA : QMG 


QUEUE 

MANAGER 


LPO: 

unspooled 
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3.  The  default  print  queue  PRINT  was  initialized  in  the  previous 
stepf  but  you  must  initialize  at  least  one  more  queue  named 
for  each  line  printer.  This  queue  will  serve  the  many  system 
tasks  that  conventionally  send  output  to  LP:  by  directing 
this  output  to  QMG .  This  is  known  as  a  device-specific 
queue.  PRINT  is  a  general  queue. 

A  device-specific  queue  must  be  initialized  before  the 
associated  device  is  initialized  (spooled).  For  LPO:,  the 
device-specific  queue  is  named  LPO. 

DC L> INITIALIZE/QUEUE  LPO/PRINT 

MCR>QUE  LPO :/CR : P 


QUEUE 

MANAGER 


unspooled 


ZK-156-81 

Initialization  names,  creates,  and  starts  a  queue. 


You  will  need  this  extra  queue  even  if  your  system  has  only 
one  printing  device.  You  can  initialize  as  many  as  14 
additional  print  queues  for  a  total  of  16.  One  must  be  the 
default  queue  PRINT.  The  remaining  15  can  be  device-specific 
or  general  queues.  There  must  be  a  device-specific  queue  for 
every  spooled  (initialized)  output  device.  Queues  for 
application  processors  are  print  queues. 
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4.  Now  you  must  install  the  print  processors.  You  must  install 
a  print  processor  for  each  physical  printing  device  that  will 
be  set  spooled  (by  means  of  INITIALIZE).  This  processor 
"owns"  the  printer;  the  processor  name  must  be  derived  from 
the  printer  name.  LPO:  is  owned  by  LPO.  LPP.TSK  installs 
automatically  as  LPO.  The  print  processors  will  be  found 
with  the  privileged  utility  tasks. 

DCL>INSTALL  $LPP 


unspooled 


MCR>INS  $LPP 


QUEUE 

MANAGER 


>  SUBMIT 


If  you  have  additional  output  devices,  use  the  /TASK 
qualifier  to  install  their  print  processors  under  the  proper 
names.  You  can  initialize  as  many  as  15  print  processors. 
Applications  processors  are  considered  print  processors  for 
this  count. 


DCL>INSTALL/TASK: LP1  $LPP 


MCR>INS  $LPP/TASK=LP1 
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5.  You  must  initialize  your  print  processors,  setting  whatever 
attributes  you  wish.  Any  initialization  of  a  print  processor 
sets  the  associated  output  device  spooled. 

DCL>INITIALIZ  E/ PR INTER  LPO/FLAG_PAGE : 2/FORM : O/LOWERCASE 

MCR>QUE  LPO :/SP/FL : 2/FO : O/LOW 


>  SUBMIT 


The  command  assigns  the  queue  LPO  to 
queue  must  exist  before  you  initialize 


despooler  LPO. 
the  processor  LPO. 


The 
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6.  Next,  you  must  install  the  interface  between  the  Queue 
Manager  and  other  system  tasks.  This  interface  is  handled  by 
$QMGPRT . TSK .  It  must  be  installed  as  PRT. . . .  It  will  be 
found  with  the  nonpr ivi leged  utility  tasks. 

DCL>INSTALL/TASK : PRT. . .  $QMGPRT 

MCR>INS  $QMGPRT/TASK=PRT. . . 


SUBMIT 


ZK-1 59-81 


SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


7.  Now,  you  must  assign  queues  to  print  processors.  Assignment 
establishes  the  path  between  queue  and  print  processor.  The 
Queue  Manager  can  send  jobs  only  to  assigned  processors. 

DCL>ASSIGN/QUEUE  PRINT  LPO 

MCR>QUE  LPO :/AS: PRINT 


QUEUE 

MANAGER 


ZK- 160-81 

Since  queue  LPO  was  assigned  to  processor  LPO  at 
ini t ial i za tion ,  this  means  two  queues  are  being  assigned  to 
the  same  processor. 


You  can  assign  a  queue  to  more  than  one  processor  and  you  can 
assign  more  than  one  queue  to  a  processor. 


If  you  initialize  a  queue,  but  do  not  assign  it,  jobs  sent  to 
that  queue  will  not  be  processed  until  the  queue  is  assigned. 

This  completes  the  installation  process  for  the  RSX-11M  QMG. 
The  remaining  steps  apply  to  RSX-11M-PLUS  only. 
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8.  You  must  now  install  the  batch  processor, 
found  with  the  privileged  utility  tasks. 

DCL>INSTALL  $BPR 

MCR>INS  $BPR 


This  task  will  be 


>  SUBMIT 


>  PRINT  1 

BPR.TSK  installs  automatically  as  BAPO . 

You  can  install  as  many  as  16  batch  processors, 
have  names  in  the  form  BAPn. 


They  must 


/ 
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9.  Now  you  initialize  the  batch  processors. 
DCL>INI/BATCH_PROCESSOR  BAPO 
MCR>QUE  BAPO : /BATCH 


>  SUBMIT 


ifiip: :  . 

. 

. — » 


■ 


****  ill 


- . —nm  mi  iiiii 


>  PRINT  ’ 
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€ 


10.  The  default  queue  BATCH  was  initialized  by 

START/ QUEUE/MANAGER,  but  you  may  initialize  as  many  as  15 
additional  batch  queues  with  names  of  as  many  as  six 
alphanumeric  characters  in  any  form. 

DCL>INI/Q  POGO/BATCH 

MCR> QUE  POGO : /CR : B 


QUEUE 

MANAGER 

>  SUBMIT 


>  PRINT 

ZK- 163*81 

Note  that  batch  processors  do  not  need  device-specific  queues 
because  no  devices  are  associated  with  them. 
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11.  Finally,  you  must  assign  batch  queues  to  batch  processors. 
DCL>ASSIGN/Q  BATCH  BAPO 
MCR>QUE  BAPO :/AS: BATCH 


BAPO 

QUEUE 

MANAGER 

>  SUBMIT 


>  print' 

ZK-1 53-81 

If  you  initialize  a  queue  but  do  not  assign  it  to  a 
processor,  jobs  can  be  queued,  but  will  not  be  processed 
until  the  queue  is  assigned. 


7.2  QUEUE  MANAGER  COMMAND  DESCRIPTIONS 

The  operations  of  QMG  are  controlled  through  a  number  of  DCL  and  MCR 
commands.  The  functions  invoked  are  identical,  but  the  command  syntax 
is  different.  Use  whichever  command  syntax  you  are  accustomed  to.  In 
this  .  manual,  both  forms  of  the  syntax  appear  in  the  command 
descriptions.  The  DCL  commands  and  command  elements  are  to  the  left 
and  the  MCR  to  the  right.  In  the  section  titles,  MCR  commands  or 
command  elements  appear  in  parentheses.  In  the  examples,  commands  are 
identified  explicitly  by  the  DCL>  and  MCR>  prompts. 

The  processors,  devices,  and  device-specific  queues  all  have  names 
derived  from  the  name  of  the  spooled  device.  Thus,  if  LP1:  is  the 
spooled  device,  the  processor  that  "owns”  it  is  called  LP1  and  the 
device-specific  queue  is  also  called  LP1.  The  colon  (:)  portion  of 
the  device  name  can  be  omitted  from  references  in  DCL  commands  to 
processors,  devices,  and  queues.  The  colon  portion  must  be  included 
in  references  in  MCR  commands  to  processors,  devices,  and  queues.  You 
can  include  the  colon  portion  in  any  DCL  command,  but  it  is  required 
only  in  MCR  commands.  Further,  in  MCR  commands,  all  queue  names  must 
be  terminated  by  a  colon,  whether  they  are  derived  from  device  names 
or  not.  Thus,  if  you  wish  to  refer  to  a  queue  named  XPRESS  in  an  MCR 
command,  you  must  refer  to  that  queue  as  XPRESS:. 
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The  general  format  of  DCL  QMG  commands  is: 

DCL>DCLcommand/QMGqual i f ier [ s]  parameter [s] [/qual i f ier [ s] ] 

The  general  format  of  MCR  QMG  commands  is: 

MCR>QUE  ddnn:  /f unction [ :opt ion [ s] ] [/sw [ s] ] 

Command  descriptions  are  given  in  the  order  they  are  used  in  the 
narrative,  except  that  any  counteracting  commands  are  described  just 
after  the  set-up  commands  they  counteract. 


7.2.1  INITIALIZE/  (QUE  /CR/SP) 

These  commands  create,  name,  and  start  a  queue  or  processor. 

When  you  initialize  an  output  processor,  you  are  setting  its 
corresponding  device  spooled.  A  spooled  device  can  be  accessed  by  the 
Queue  Manager.  The  processor  or  task  must  be  installed. 


7. 2. 1.1  INITIALIZE/QUEUE  (QUE  /CR)  -  INITIALIZE/QUEUE  creates,  names, 
and  starts  a  queue. 

Format 

DC L> INITIALIZE/QUEUE  queue name/ qual i f ier 
DCL  Parameter  Qualifiers 

/BATCH 

/PRINT 

MCR>QUE  ddnn :/CR : typ 

MCR  Queue  Types 

PRINT 

BATCH 


Parameter 

queuename 

Specifies  the  name  of  the  queue  to  be  initialized. 

Queue  names  BATCH  and  PRINT  are  reserved,  because  the  BATCH  and 
PRINT  queues  are  initialized  by  the  START/QUEUE/MANAGER  (QUE 
/STA : QMG)  command . 

The  queue  named  BATCH  is  initialized  on  RSX-11M  systems,  but  is 
not  used,  and  is  not  accessible  or  displayed. 

You  must  initialize  a  queue  for  every  output  device  to  which  the 
Queue  Manager  is  to  send  print  jobs.  These  are  called 
d ev ice- spec i fie  queues . 

Otherwise,  any  six  alphanumeric  characters  make  an  acceptable 
queue  name  for  a  general  queue.  If  you  have  no  processor  LP1, 
LP1  is  then  a  general  queue  name. 

Device-specific  queues  must  be  initialized  before  the  associated 
processo  r . 
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Parameter  Qual i f iers 

This  qualifier  can  be  either  /BATCH  or  /PRINT.  The  qualifier 
tells  the  Queue  Manager  what  kind  of  queue  is  being  initialized. 
Queues  for  applications  processors  are  print  queues. 

The  default  qualifier  is  /PRINT.  For  the  sake  of  clarity,  you 
should  always  include  the  qualifier  when  initializing  a  queue. 

Examples 


DCL> INITIALIZE/QUEUE  XPRESS/PRINT 
MCR>QUE  XPRESS :/CR:PRINT 

This  example  creates,  names,  and  starts  a  print  queue  named 
XPRESS.  The  queue  can  now  accept  print  jobs,  but  it  must  be 
assigned  to  an  output  processor  before  jobs  can  be  taken  from  the 
queue . 


DCL> ASS IGN/ QUEUE  XPRESS  LPO : 

MCR>QUE  LPO:/AS:XPRESS 

This  command  assigns  the  queue  initialized  in  the  previous 
example  to  a  print  processor. 


DCL>INITIALIZE/QUEUE  LPO/PRINT 
DCL> INITIAL I Z E/PRINTER  LPO: 

MCR>QUE  LPO : /CR 
MCR>QUE  LPO : /SP 

This  example  creates,  names,  and  starts  a  print  queue  named  LPO. 
This  is  a  device-specific  queue.  Its  name  is  derived  from  the 
name  of  an  output  device.  This  queue  must  be  initialized  before 
the  output  device  despooler  can  be  initialized.  After  both  the 
queue  and  output  device  despooler  are  initialized,  the  queue  can 
accept  print  jobs  and  the  named  printer  is  set  spooled.  Jobs  can 
be  placed  in  the  queue. 


Notes 


No  more  than  16  print  queues  (including  queues  for  applications 
processors)  can  be  initialized. 


On  RSX-11M-PLUS,  no  more  than  16  batch  queues  can  be  initialized. 


These  counts  include  the  default  PRINT  and  BATCH  queues. 


7. 2. 1.2  INITIALIZE/PROCESSOR  (QUE  /SP)  -  This  command  creates,  names, 
and  .  starts  an  output  despooler  or  batch  processor.  When  you 
initialize  an  output  despooler,  this  task  "owns"  a  hardware  device. 
This  is  setting  the  device  spooled.  A  spooled  device  can  be  accessed 
by  the  Queue  Manager. 
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Format 


DCL>INITIALIZE/qual i f ier  processorname/qual i f ier 

/APPLICATIONS_PROCESSOR 
/BATCH_PROCESSOR 
/PROCESSOR 


MCR>QUE  processorname :/SP[/sw[s] ] 

DCL  Command  Qualifiers  MCR  Function 


/PROCESSOR  /SP 

/PRINTER  /SP 

/DEVICE  /SP 

/BATCH_PROCESSOR  /BA 

/APPLICATIONS  PROCESSOR  /SP/EX 


DCL  Parameter  Qualifiers 


MCR  Switches 


/FLAG_PAGE:n  /FL : n 

/LOWERCASE  /LOW 

/UPPERCASE  /NOLO 

/FORMS :n  /FO:n 

/SHAREABLE  /SHR 


Command  Qualifiers 


/PROCESSOR  (/SP) 
/PRINTER  (/SP) 
/DEVICE  (/SP) 


The  DCL  command  qualifiers  fall  in  three  groups.  One  group 
consists  of  /PROCESSOR ,  /PRINTER ,  and  /DEVICE.  These  three  are 
synonyms.  The  effect  of  each  is  the  same.  The  synonyms  are 
provided  to  assure  unambiguous  commands  and  documentation.  Use 
/PRINTER  for  line  printers  and  /DEVICE  for  other  output  devices. 


If  you  use  one  of  these  three  synonyms,  a  device-specific  queue 
must  exist  before  the  output  despooler  task  can  be  initialized. 
See  Notes. 

The  MCR  /SP  switch  performs  the  same  function.  There  are  no 
synonyms  in  the  MCR  form  of  this  command.  A  device-specific 
queue  must  exist  before  the  output  despooler  task  can  be 
initialized.  See  Notes. 


/BATCH_PROCESSOR  (/BA) 

Use  this  qualifier  (or  option)  when  initializing  a  batch 
processor . 


/APPLICATIONS  PROCESSOR  (/SP/EX) 


Use  this  qualifier  when  the  destination  of  the  output  is  not  a 
physical  device,  but  rather  some  software  application.  Use 
/ APPLICATIONS_PROCESSOR  when  you  are  initializing  a  user-written 
output  despooler  for  which  the  physical  device  is  not  currently 
in  the  system.  This  makes  it  possible  for  the  Queue  Manager  to 
despool  output  to  an  applications  task,  to  a  network,  or  to  some 
other  instance  of  down-line  loading. 

In  MCR  format,  you  must  combine  the  /SP  and  /EX  options. 
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When  you  use  this  command  in  either  form,  the  Queue  Manager  does 
not  check  for  the  existence  of  a  physical  device  before 
initializing  the  processor. 

Parameter 

processorname 

Remember,  the  names  of  the  device,  processor,  and  queue  are  the 
same,  and  interchangeable.  MCR  users  must  include  the  colon 
(  :  )  but  DCL  users  can  omit  it. 

You  must  initialize  device-specific  queues  before  you  initialize 
the  print  processor  with  the  same  number. 

If  initializing  a  batch  processor,  its  name  must  be  in  the  form 
BAPn . 

DCL  Parameter  Qualifiers  and  MCR  Functions 

These  qualifiers  and  functions  have  meaning  for  initializing 
print  processors  only. 

With  the  exception  of  setting  the  number  of  flag  pages,  these 
qualifiers  have  no  effect  on  the  printed  output  of  the  printer 
being  initialized.  Rather,  these  qualifiers  define  the  kind  of 
print  jobs  the  processor  can  accept. 

Different  kinds  of  print  jobs  are  established  by  the  PRINT 
command  which  places  them  in  the  queue. 

/ F L AG_P AG E : n  (/FL:n) 

Specifies  how  many  flag  pages  are  to  precede  jobs  and  files 
printed  by  this  processor.  Default  is  0;  n  must  be  0,  1,  or  2. 

If  the  processor  is  being  initialized  to  accept  special  forms, 
you  may  want  to  set  this  qualifier  to  0. 

If  you  wish,  you  can  change  the  value  set  here  with  the  /FLAG 
qualifier  to  the  START/  command  (/FL  switch  to  /STA  option). 

/LOWERCASE  (/LOW) 

If  you  initialize  a  printer  as  lowercase,  that  printer  will 
accept  print  jobs  with  lowercase  or  uppercase  specified  in  the 
PRINT  command.  Normally,  you  should  not  use  this  qualifier 
unless  the  hardware  involved  has  both  the  uppercase  and  lowercase 
character  sets.  This  is  the  default. 

/UPPERCASE  (/NOLO) 

If  you  initialize  a  printer  as  uppercase,  that  printer  will  not 
accept  print  jobs  with  lowercase  specified  in  the  PRINT  command. 
Normally,  you  should  not  use  this  qualifier  unless  the  hardware 
involved  does  not  have  the  lowercase  character  set. 

/FORMS :n  (/FO:n) 


This  number  can  be 

0. 

anything  from 

0  through  255. 

The 

default  is 

These  numbers  are 
commands . 

to  be  specified 

by  your  users 

in 

their  PRINT 
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You  should  determine  which  forms  will  be  used  on  your  system  and 
assign  each  a  number.  You  should  then  edit  the  file 
LB : [ 1 , 24] LPPBLD. CMD  to  set  up  the  forms  table  for  the  print 
processor  to  correspond  to  the  numbers  you  have  assigned  to  the 
forms.  Then  you  must  build  the  processor. 

If  the  right  forms  are  not  in  an  available  printer,  then  their 
jobs  will  be  waiting  until  the  printer  has  been  stopped,  the 
proper  forms  put  in  place,  and  the  printer  restarted  with  a  new 
value  for  /FORMS  (/FO) . 

Forms  differ  by  their  length  and  width.  Both  values  can  be  set 
in  the  forms  table. 

Setting  width  is  simply  a  matter  of  determining  how  many  columns 
are  needed  to  fill  in  the  form.  There  are  no  standard  widths  for 
forms,  but  80  and  132  are  the  most  common. 

Setting  length  requires  you  to  determine  whether  your  forms  are 
of  a  standard  length. 

"Standard  length"  is  any  form  length  that  can  be  set  on  your 
printing  hardware.  If  the  hardware  can  handle  the  form  by 
setting  a  response  to  a  form-feed  character,  then  it  is  a 
standard  length  form,  and  the  form  feed  is  a  "real,"  that  is, 
hardware,  form  feed. 

If  the  form  length  cannot  be  set  on  the  hardware,  then  it  is  a 
nonstandard  length.  In  this  case,  the  form  feed  must  be  replaced 
by  an  appropriate  number  of  line  feeds.  This  is  called  a 
"simulated,"  that  is,  software,  form  feed. 

The  following  table  shows  the  forms  requirements  for  a 
hypothetical  installation.  The  form  names  describe  different 
uses  that  special  forms  might  be  put  to,  but  have  no  significance 
otherwise . 


Form 

Assigned  n 

Width 

Length 

Standard? 

Accordion 

0 

132 

66 

Y 

Paychecks 

1 

40 

10 

Y 

Invoices 

2 

80 

66 

Y 

Stationery 

3 

80 

66 

Y 

Moon  Diary 

4 

22 

43 

N 

Star  Log 

5 

112 

113 

N 

The  forms  table 

can  be  changed  at 

LB: [1,24] 

LPPBLD. CMD . 

procedure  is  explained  in  the 

comments 

in  this 

file. 

As  shipped,  FORMS : 0  is  66  lines  long  by  132  columns  with  real 
form  feeds.  F0RMS:1  is  1  line  long  by  132  columns  with  simulated 
form  feeds;  F0RMS:2  is  2  lines  long  by  132  columns  with 
simulated  form  feeds;  and  so  on  through  FORMS:66  which  is  66 
lines  long  by  132  columns  with  simulated  form  feeds.  The 
remaining  FORMS:n  entries  are  set  to  1  line  long  by  132  columns 
with  simulated  form  feeds.  Thus,  if  you  specify  /FORMS:43,  when 
the  printer  encounters  a  form  feed,  it  will  count  the  number  of 
lines  on  the  page  and  subtract  that  number  from  43.  The  printer 
will  then  reel  off  a  number  of  line  feeds  equal  to  the 
difference.  You  may  find  this  arrangement  satisfactory  if  your 
installation  rarely  uses  forms  other  than  standard  line-printer 
paper,  but  if  you  have  more  than  one  standard  form,  you  will 
probably  want  to  make  the  changes  in  the  forms  table  entries. 
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/SHAREABLE  (/SHR) 

Establishes  the  processor  as  shareable.  This  means  the  physical 
device  is  not  "owned"  by  a  processor  if  it  is  not  printing  a  job. 
Normally,  the  output  processor  attaches  the  device  when  it  is 
initialized  and  no  other  job  can  access  the  device  until  it  is 
detached . 

If  you  initialize  the  processor  as  shareable,  the  device  is 
attached  at  the  beginning  of  the  QMG  print  job  and  detached  at 
the  end  of  the  job,  leaving  the  device  free  for  other  uses. 

On  RSX-11M-PLUS,  if  you  initialize  a  processor  as  shareable, 
transparent  spooling  to  that  device  will  not  work. 

Examples 


dcl>initialize/processor  LPO : 

MCR>QUE  LPO : /SP 

LPO:  is  set  spooled.  Jobs  can  be  passed  to  it  from  the  Queue 

Manager . 

You  must  initialize  a  device-specific  queue  named  LPO  before  you 
can  initialize  the  processor  for  device  LPO:. 


DCL> INITIALIZE/PRINTER/FLAG_PAGE : 2  LP1 : 

MCR>QUE  LP1 :/SP/FL : 2 

This  command  initializes  a  print  processor  to  control  LP1:  and 

specifies  that  jobs  run  on  this  printer  will  be  preceded  by  two 
flag  pages.  Jobs  specifying  flag  pages  in  the  PRINT  command  will 
have  two  flag  pages  at  the  head  of  the  job. 


DCL> INITIALIZE/PRINTER/  LP1/N0L0WER 


MCR>QUE  LP1 :/SP/NOLOW 


This  command  initializes  a  print  processor  to  control 
states  that  the  printer  will  only  accept  jobs 
uppercase  in  the  PRINT  command. 


LP1 :  and 
specifying 


DCL> INI/BATCH_PROCESSOR  BAPO 
MCR>QUE  BAPO :/BA 

This  command  creates,  names,  and  starts  batch  processor  BAPO,  on 
an  RSX-1 1M-PLUS  system. 


DCL> INI/PRO  LPO/FLAG : 2/FORMS : O/LOWER 
MCR>QUE  LPO : /SP/FL : 2/FO : O/LOW 

This  command  creates,  names,  and  starts  print  processor  LPO.  The 
printer  has  the  lower-case  character  set.  Jobs  will  have  two 
flag  pages  when  printed. 
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Notes 


No  more  than  16  batch  processors  on  an  RSX-11M-PLUS  system,  or  16 
print  processors  (including  applications  processors)  can  be 
initial i zed . 


If  you  are  initializing  an  output  despooler  that  attaches  a 
physical  device,  the  system  checks  for  the  existence  of  the 
device  and  of  its  device-specific  queue  before  the  command  is 
executed.  Therefore,  the  following  procedure  must  be  followed. 


1.  The  device  must  be  part  of  the  current  system. 

2.  You  must  initialize  a  device-specific  queue  for  the 
device  before  you  initialize  an  output  despooler  of  the 
same  type  and  number. 

When  you  initialize  an  output  processor,  it  is  named  and 
started  and  has  its  device-specific  queue  assigned  to  it. 

3.  For  each  print  processor,  there  must  be  a  print  queue, 
called  the  device-specific  queue,  with  a  corresponding 
name.  The  printer  named  LPO :  is  owned  by  the  output 
despooler  named  LPO.  There  must  also  be  a 
device-specific  queue  named  LPO.  The  processor  cannot  be 
named  until  the  device-specific  queue  has  been 
initialized.  This  queue  will  be  assigned  automatically 
to  the  processor  whose  name  it  shares,  but  the 
device-specific  queue  can  be  deassigned  and  assigned 
elsewhere  after  initialization. 

This  procedure  does  not  apply  to  initializing  batch 
processors  or  applications  processors.  Neither  a 
physical  device  nor  a  device-specific  queue  is  needed  to 
initialize  a  batch  processor  or  applications  processor. 

There  can  also  be  print  queues  whose  names  do  not 
correspond  to  output  devices.  These  are  called  general 
queues . 

The  lowercase/uppercase  attributes  have  no  effect  on  the  nature 
of  the  printer's  output.  They  do  not  cause  jobs  to  be  printed 
all  uppercase.  These  qualifiers  set  up  a  "mask"  that  must  be 
matched  by  the  attributes  of  print  jobs  before  they  can  be  sent 
to  the  printer.  A  printer  without  the  lowercase  character  set 
can  be  initialized  lowercase  and  it  will  accept  print  jobs  with 
lowercase  specified  in  the  PRINT  command.  This  might  be  done  if 
a  printer  with  the  lowercase  character  set  was  temporarily 
unavailable.  As  a  general  rule,  however,  you  should  only 
initialize  printers  with  the  characteristics  they  actually  have 
to  avoid  confusion. 

(The  line  printer  driver  does,  however,  affect  the  printer's 
output,  through  lowercase-to-uppercase  translation.  See  the 
discussion  of  SET  /LOWER  in  the  RSX-1 1M/RSX-1 1M- PLUS  MCR 
Operations  Manual,  or  the  discussion  of  SET  DEVICE  /LOWER  in  the 
RSX-1 1 M/M- PLUS  Command  Language  Manual . ) 


7.2.2  DELETE/  (QUE  /DEL) 

You  can  delete  queues  or  prbcessors. 
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7. 2. 2.1  DELETE/QUEUE  (QUE  /DEL:Q)  -  DELETE/QUEUE  deletes 
name . 

Formats 


queues  by 


DC L> DELETE/ QUEUE  queuename/ERASE 
MCR>QUE  queuename :/DEL:Q 


Parameters 


queuename/ERASE  (/DEL : Q) 

Specifies  the  name  of  a  queue  to  be  deleted.  Only  a  privileged 
user  can  delete  a  queue  using  this  parameter.  The  default  queues 
BATCH  and  PRINT  cannot  be  deleted. 

If  the  queue  has  jobs  in  it,  it  will  be  marked  for  delete.  When 
the  last  job  leaves  the  queue,  the  queue  itself  is  deleted.  No 
new  jobs  can  be  entered. 


You  cannot  delete  device-specific  queues  until 
deleted  the  processor  with  the  same  number.  See 


after  you  have 
next  section. 


Examples 


DC L> DELETE/ QUEUE  MONA/ERASE 


MCR>que  MONA :/DEL : Q 


This  privileged  command  deletes  the  queue  named  MONA  if  it 
empty.  If  the  queue  has  entries,  it  is  marked  for  delete, 
will  be  deleted  as  soon  as  the  last  job  is  removed  from 
queue.  Note  the  colon  in  the  queue  name  in  the  MCR  example. 


is 

and 

the 


7. 2. 2. 2  DELETE/PROCESSOR  (QUE  /UNSP)  -  DELETE/PROCESSOR  deletes  print 
processors,  output  despoolers,  or  batch  processors  by  name.  The 
command  also  sets  the  device  unspooled. 

Format 


DCL>DELETE/qual i f i er 

/APPLICATIONS  PROCESSOR 

/BATCH_PROCESSOR 

/PROCESSOR 


processorname 


MCR>QUE  processorname :/UNSP 


DCL  Command  Qualifiers 


MCR  Functions 


/PROCESSOR  /UNSP 
/PRINTER  /UNSp 
/DEVICE  /UNSp 
/BATCH_PROCESSOR  /UNBA 
/APPLICATIONS_PROCESSOR  /UNSP 


Parameters 


processorname 


For  physical  devices,  the  name  of  the 
the  name  of  the  physical  device. 


processor  is  identical 
Thus,  the  device  LP1: 


wi  th 
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controlled  by  processor  LP1:.  DCL  commands  do  not  require  that 
you  include  the  colon  (:),  but  you  must  include  the  colon  in  all 
MCR  commands • 

Batch  processors  have  names  in  the  form  BAPnnn,  where  nnn  is  from 
one  through  three  Radix-50  characters. 

Applications  processors  have  names  of  six  Radix-50  characters. 

Command  Qualifiers 

/PROCESSOR  (/UNSP) 

/PRINTER 

/DEVICE 

The  DCL  command  qualifiers  fall  in  three  groups.  One  group 
consists  of  /PROCESSOR,  /PRINTER,  and  /DEVICE.  These  three  are 
synonyms.  The  effect  of  each  is  the  same.  The  synonyms  are 
provided  to  assure  unambiguous  commands  and  documentation.  Use 
/PRINTER  for  line  printers  and  /DEVICE  for  other  output  devices. 

If  you  use  one  of  these  three  synonyms,  the  device-specific  queue 
cannot  be  deleted  until  after  the  output  despooler  task  is 
deleted . 

These  distinctions  do  not  apply  in  MCR. 


/BATCH__PROCESSOR  (/UNBA) 

Use  this  qualifier  when  deleting  a  batch  processor. 


/APPLICATIONS_PROCESSOR  (/UNSP) 

Use  this  qualifier  when  the  destination  of  the  output  is  not  a 
physical  device,  but  rather  some  software  application.  Use 
/APPLICATIONS_PROCESSOR  when  you  are  deleting  a  user-written 
output  despooler. 

Examples 

DCL>DELETE/PROCESSOR  LPO 
MCR>QUE  LPO: /UNSP 

This  example  deletes  processor  LPO,  the  owner  of  line  printer 
LPO:  . 


DCL>DELETE/BATCH_PROCESSOR  BAP2 
MCR>QUE  BAP2 : /UNBA 

The  commands  are  equivalent;  they  delete  the  batch  processor 
named  BAP2 ,  on  an  RSX-11M-PLUS  system.  Note  the  colon  in  the  MCR 
command . 


DCL>DELETE/PROCESSOR  LPO 
DCL>DELETE/QUEUE  LPO/ERASE 

MCR>QUE  LPO : /UNSP 
MCR>QUE  LPO : /DEL : Q 

This  example  shows  the  order  you  must  follow  to  delete  a 
dev ice- specific  queue . 
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Notes 

DELETE/PROCESSOR  (/UNSP)  counteracts  INITIALIZE/PROCESSOR  (/SP) . 

For  maximum  clarity,  operators  using  DCL  should  use  the  specific 
qualifiers  /PRINTER  and  /DEVICE  rather  than  the  synonym 
/PROCESSOR  when  deleting  output  despoolers. 

7.2.3  ASSIGN/QUEUE  (QUE  /AS:) 

ASSIGN/QUEUE  (QUE  /AS:)  establishes  a  path  from  a  queue  to  a 
processor . 

Format 

DC L> AS SIGN/ QUEUE  queue name  processo rname 
MCR>QUE  processo  rname : /AS : queue name 
Parameters 
queuename 

Specifies  the  queue  that  is  to  be  assigned  to  the  processor, 
processorname 

Specifies  the  processor  to  which  the  queue  is  to  be  assigned. 

When  assigning  queues  to  output  devices,  use  the  the  device  name 
in  the  form  ddnn :  . 

Notes 

This  command  can  be  used  to  redirect  output  from  one  processor  to 
another . 

Other  uses  include  grouping  related  processors,  such  as  plotters, 
under  a  single  queue. 

7.2.4  DEASSIGN/QUEUE  (QUE  /DEA) 

DEASSIGN/QUEUE  (QUE  /DEA)  counteracts  ASSIGN/QUEUE  (/AS) .  It  is  used 
to  eliminate  the  path  from  a  queue  to  a  processor. 

Format 

DCL>DEASSIGN/ QUEUE  queuename  processorname 
MCR>QUE  processorname : /DEA : queuename 
Parameters 
queuename 

Specifies  the  queue  that  is  to  be  deassigned  from  the  processor. 
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processorname 

Specifies  the  processor  from  which  the  queue  is  to  be  deassigned. 

When  deassigning  queues  from  output  devices,  use  the  device  name 
in  the  form  ddnn :  . 


7.2.5  STOP/  (QUE  /STO) 

STOP/  (/STO)  is  used  to  stop  queues,  the  Queue  Manager,  or  a 
processor . 


7. 2. 5.1  STOP/QUEUE  (QUE  /STOrQUE)  -  STOP/QUEUE  stops  queues. 
Format 

DC L> STOP/ QUEUE  queuename 
MCR>QUE  queuename :/STO : QUE 

Parameter 


queuename 


Specifies  the  queue  to  be  stopped.  Following  the  command ,  no 
jobs  will  be  taken  from  the  queue,  but  jobs  can  still  be  added  to 
the  queue. 


If  a  job  is  active  at  the  time  this  command  is  issued,  the  job 
will  be  allowed  to  complete  processing  but  no  further  jobs  will 
be  dequeued. 


Note  the  colon  (:)  in  the  MCR  form  of  the  command. 


7. 2. 5. 2  STOP/QUEUE/MANAGER  (/STO:QMG)  -  STOP/QUEUE/MANAGER  (/STOxQMG) 
stops  the  Queue  Manager  and  deletes  all  processors,  whether  batch 
processors  or  output  despoolers. 

Format 


DCL>STOP/QUEUE/MANAGER [/ABORT] 
MCR>QUE  /STO : QMG [ : AB] 


Notes 

If  you  issue  this  command  without  the  /ABORT  (:AB)  qualifier,  QMG 
is  marked  for  stop.  As  soon  as  all  currently  active  jobs  on  all 
processors  are  done,  QMG  will  stop.  No  more  jobs  can  be  entered 
in  the  queue.  See  also  example  in  Section  7. 2. 6. 2. 


If  you  include  the  /ABORT  (:AB)  qualifier,  all  active 
held  immediately  and  QMG  exits  without  further  delay. 


jobs  are 


7-23 


SETTING  UP  AND  RUNNING  THE  QUEUE  MANAGER 


7. 2. 5. 3  STOP/PROCESSOR  (QUE  /STO)  -  STOP/PROCESSOR  (/STO)  stops  a 
processor . 

Format 


DC L> STOP/ qual i f ier  processo rname  f/qual i f ier] 

/APPLICATIONS_PROCESSOR 
/BATCH_PROCESSOR 
/PROCESSOR 


MCR>QUE  processorname :/STO[ :opt] 


DCL  Command  Qualifiers  MCR  Functions 

/PROCESSOR  /STO 
/PRINTER  /STO 
/DEVICE  /STO 
/APPLICATIONS  PROCESSOR  /STO 
/BATCH PROCESSOR  /STO 


DCL  Parameter  Qualifiers 


MCR  Options 


/PAUSE 
/JOB_END 
/FI LE_END 
/ABORT 


<no  equivalent> 
:  EOJ 
:  EOF 
:  AB 


Parameter 

processorname 


When 

ddnn 

stopping 

print 

processors 

,  use  the  device  name 

in  the 

form 

This 

command 

has  no 

effect  on 

the  status  of  jobs  in 

queues , 

but 

no  jobs  will  be  dequeued  while  the  processor  is  stopped. 
Command  Qualifiers 


/PROCESSOR  (/STO) 

/PRINTER 

/DEVICE 


The  DCL  qualifiers  are  synonyms.  The  effect  of  each  is  the  same. 
These  synonyms  are  provided  to  assure  unambiguous  commands  and 
documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for  other 
output  devices,  and  /BATCH_PROCESSOR  for  batch  processors.  MCR 
users  use  /STO  across  the  board. 


/BATCH_PROCESSOR  (/STO) 

Use  this  qualifier  when  stopping  a  batch  processor. 
/APPLICATIONS_PROCESSOR  (/STO) 


Use  this  qualifier  when  the  destination  of  the  output  is  not  a 
physical  device,  but  rather  some  software  application.  Use 
/APPLICATIONS_PROCESSOR  when  you  are  stopping  a  user-written 
output  despooler. 
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Parameter  Qualifiers 

Only  one  qualifier  is  permitted.  The  choice  of  qualifier  here 
affects  the  restarting  of  jobs  when  the  processor  is  started 
again. 

/PAUSE  <no  equivalent 

This  is  the  default;  it  causes  the  processor  to  stop  at  the  end 
of  the  current  line.  There  is  no  MCR  qualifier;  /STO  is 
sufficient . 

/JOB_END  (sEOJ) 

Causes  the  processor  to  stop  at  end  of  the  current  job. 

/FILE_END  ( : EOF) 

Causes  the  processor  to  stop  at  end  of  the  current  file. 

/ABORT  ( : AB) 

Causes  the  processor  to  stop  immediately.  The  current  job  is 
held  in  its  queue. 


Notes 


This  command  is  counteracted  by  START/PROCESSOR  (/STA) .  You 
cannot  issue  START/PROCESSOR  (/STA)  until  the  processor  actually 
stops . 


7. 2. 5. 4  STOP/ABORT  (QUE  /KIL)  -  STOP/ABORT  (/KIL)  deletes  the  active 
job  on  a  given  processor.  Privileged  users  can  delete  any  job; 
nonprivileged  users  can  delete  their  own  jobs.  You  do  not  need  to 
know  the  queue  name  or  job  name  to  delete  the  job,  only  the  name  of 
the  processor. 

Format 

DC L> STOP/ ABORT  processo rname 
MCR>QUE  processorname :/KIL 
processorname 

Specifies  the  processor  whose  active  job  you  wish  to  delete. 
Note  that  the  MCR  command  format  requires  a  colon  (:)  after  the 
processor  name. 

You  can  stop  jobs  running  on  any  processor  under  the  control  of 
QMG ,  including  RSX-11M-PLUS  batch  processors. 

Examples 

DCL> STOP/ABORT 
Processor?  LPO 

This  example  shows  how  to  stop  a  print  job  on  LPO:  The  currently 
active  job  is  deleted  from  the  queue  and  the  next  eligible  job  is 
queued . 
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Notes 


Use  this  command  to  stop  a  processor  fast,  such  as  a  line  printer 
printing  nothing  but  form  feeds. 


As  soon  as  the  active  job  is  deleted,  QMG  passes  the  next 
eligible  job  to  the  processor.  The  processor  has  not  been 
aborted  or  killed,  only  the  active  job  on  that  processor. 


You  can  also  delete  the  active  job  on  a  card-reader  processor 
with  this  command. 


7.2.6  START/  (QUE  /STA) 

START/  (QUE  /STA)  is  used  to  start  a  queue,  the  Queue  Manager,  or  a 
processor.  START/  (QUE  /STA)  counteracts  STOP/  (/STO) . 

7. 2. 6.1  START/QUEUE  (QUE  /STA)  -  START/QUEUE  (QUE  /STA)  starts  a 
queue . 

Format 

DCL>START/QUEUE  queuename 
MCR>QUE  queuename :/STA 
Parameter 
queuename 

Specifies  the  queue  to  be  started.  This  command  starts  a  queue 
that  has  been  stopped.  Note  the  colon  (:)  in  the  MCR  format. 


7. 2. 6. 2  START/QUEUE/MANAGER  (QUE  /STA : QMG)  -  START/QUEUE/MANAGER  (QUE 
/STArQMG)  starts  the  Queue  Manager,  initializes  the  default  queues 
PRINT  and  BATCH,  and  creates  the  queue  file  LBO : [ 1 , 7] QUEUE . SYS  if  it 
does  not  exist.  The  command  also  clears  all  queue  assignments.  If 
the  queue  file  was  intact,  all  queues  will  still  contain  their  jobs, 
but  will  not  be  assigned  to  processors. 

Format 

DC L> START/ QUEUE/MANAGER 
MCR>QUE  /STA: QMG 
Examples 


DCL>START/ QUEUE/MANAGER 
MCR>QUE  /STA: QMG 

Starts  Queue  Manager.  Initializes  the  default  queues  PRINT  and 
BATCH,  if  they  are  not  already  initialized.  Clears  all 
assignments  of  queues  to  processors. 
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Any  jobs  that  were  active  at  the  time  the  Queue  Manager  was 
stopped  will  be  held  when  it  is  started  again.  All  other  jobs 
retain  the  status  they  had  when  QMG  was  stopped. 

All  processors  must  be  reinitialized. 


The  default  queue  BATCH  is  initialized  on  RSX-11M  systems  as  well 
as  RSX-1 1M-PLUS,  but  it  is  neither  accessible  nor  displayed. 


DCL> STOP/QUEUE/MANAGER 
MCR>QUE  /STO : QMG 

With  this  command,  the  Queue  Manager  is  stopped,  and  all 
processors  are  /deleted. 


DCL> START/QUEUE/MANAGER 
MCR>QUE  /STA : QMG 

This  command  clears  all  assignments  of  queues  to  processors. 


DCL> INITIALIZE/ PR INTER  LPO 

DCL> INITIALIZE/ PR INTER  LP1 

DCL> INITIALIZ  E/BATCH_PROCESSOR  BAPO 

DCL> INITIALIZ  E/BATCH_PROCESSOR  BAP1 

DCL> ASS IGN/ QUEUE  PRINT  LPO 

DC L> ASSIGN/QUEUE  PRINT  LP1 

DC L> ASSIGN/ QUEUE  BATCH  BAPO 

DC L> ASSIGN/QUEUE  BATCH  BAP1 


MCR>QUE  LPO :/SP 
MCR> QUE  LP1:/SP 
MCR>QUE  BAPO :/BA 
MCR>QUE  BAP1 :/BA 
MCR> QUE  LPO :/AS : PRINT 
MCR>QUE  LP1 : /AS : PRINT 
MCR>QUE  BAPO: /AS: BATCH 
MCR>QUE  BAP1 :/AS:BATCH 

These  commands  recreate  the  network  of  queues  and  processors.  Note 
that  RSX-11M  systems  have  no  batch  processors. 

DC L>RE LEASE/ JOB  PRINT  BOBO 

MCR>QUE  PRINT : BOBO/ RE L 

This  command  releases  a  held  job  that  was  active  at  the  time  the 
system  crashed . 


7. 2. 6. 3  START/PROCESSOR  (QUE  /STA)  -  START/PROCESSOR  (QUE  /STA) 
starts  a  batch  processor  or  output  despooler. 


Format 

DCL>START/ qual i f ier  Tprocesso rnamel  [/qual i f ier [s] ] 

Lddnn:  J 

/APPLICATIONS_PROCESSOR 

/BATCH_PROCESSOR 

/PROCESSOR 
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DCL  Command  Qualifiers  DCL  Parameter  Qualifiers 


/PROCESSOR 

/PRINTER 

/DEVICE 

/BATCH_PROCESSOR 
/APPLICATIONS  PROCESSOR 


/FORMS :n 

/FLAG : n 

/CONTINUE 

/RESTART 

/NEXT_JOB 

/TOP_OF_FILE 

/BACKSPACE :n 

/FORWARDSPACE :n 

/AT_PAGE:n 

/ALIGN 


MCR>QUE  processor name :/STA [  :opt  [  s]  ] 
MCR  Options 


:  FO  :n 
:  FL:n 


<no  equivalent> 
:  NE 


:  RES 
:  PA :  0 
:  BA:n 
:  FW:n 


:  PA:n 
/AL 

Parameters 

processorname 

ddnn: 

Specifies  the  processor  to  be  started.  When  starting  a  stopped 
output  processor,  use  the  device  name  in  the  form  ddnn:. 

Command  Qualifiers 

/PROCESSOR 

/PRINTER 

/DEVICE 

/BATCH_PROCESSOR 

/APPLICATIONS_PROCESSOR 

These  are  DCL  synonyms.  The  effect  of  each  is  the  same.  These 
synonyms  are  provided  to  assure  unambiguous  commands  and 
documentation.  Use  /PRINTER  for  line  printers,  /DEVICE  for  other 
output  devices,  /BATCH_PROCESSOR  for  batch  processors,  and 
/ APPLICATIONS_PROCESSOR  for  applications  processors.  In  MCR 
format,  use  the  /STA  option. 

Parameter  Qualifiers 

Some  qualifiers  have  meaning  for  starting  either  batch  or  print 
processors,  and  some  have  meaning  for  print  processors  only.  See 
descriptive  text. 

This  field  is  restricted.  You  can  include  either  /FORMS:  (:FO:) 
or  /FLAG:  (:FL:)  or  both,  or  you  can  include  any  one  of  the 
remaining  qualifiers,  if  permitted. 

/FORMS:  ( : FO : )  and  /FLAG:  (:FL:)  have  meaning  for  print 

processors  only. 
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/FORMS :n  (sFOsn) 

Overrides  the  forms  value  set  when  the  processor  was  initialized, 
n  can  be  any  number  from  0  through  256. 

/FLAG :n  (:FL:n) 


Overrides  the  flag  value  set  when  the  processor  was  initialized. 

When  the  processor  starts  again,  the  Queue  Manager  sends  the  next 
job  that  matches  the  attributes  of  the  processor. 

/CONTINUE 


Specifies  that  the  processor  carry  on  from  wherever  it  was 
stopped.  This  is  the  default.  MCR  format  requires  no  switch. 


/RESTART  ( : RES) 

Specifies  that  interrupted  jobs  be  restarted  from  the  beginning 
of  the  file  that  was  being  processed  when  the  processor  was 
stopped.  This  qualifier  affects  only  jobs  that  were  ACTIVE  at 
the  time  the  processor  stopped. 


This  qualifier  may  conflict  with  the  desires  of  your  users  who 
have  specified  /NORESTART  in  their  PRINT  or  SUBMIT  commands. 
This  qualifier  causes  such  jobs  to  be  restarted  at  the  start  of 
the  file  being  processed  when  the  processor  was  stopped.  You 
should  check  the  queue  display  for  such  jobs  before  using  this 
qualifier.  The  /CONTINUE  (default)  qualifier  will  not  affect 
such  jobs. 


The  action  of  this  qualifier  further  depends  on  the  qualifier  to 
the  STOP/  (/STO)  command  that  stopped  the  processor  in  the  first 
place . 

If  the  qualifier  was  /PAUSE  (the  default  for  /STO) ,  then  any  jobs 
active  at  that  time  will  be  restarted  at  their  beginning. 

If  the  qualifier  was  /FI LE_END  ( : EOF)  ,  then  any  jobs  active  at 
that  time  will  be  restarted  at  their  beginning,  unless  the  active 
file  was  the  last  one  in  the  job. 

If  the  qualifier  was  /ABORT  ( : AB)  (or  if  the  system  crashed),  the 
current  active  job  was  held  in  its  queue,  so  the  restart 
qualifier  will  have  no  effect. 

Likewise,  if  the  qualifier  was  /JOB_END,  (:EOJ)  there  will  have 
been  no  current  job,  so  the  restart  qualifier  will  have  no 
effect . 


/NEXT_JOB  ( sNE) 

Specifies  that  the  processor  start  at  the  beginning  of  the  next 
job. 

/TOP_OF_FILE  (sPAsO) 

Specifies  that  the  processor  start  at  the  top  of  the  current  file 
in  the  current  job. 

The  qualifiers  /CONTINUE  (the  default  for  /STA) ,  /RESTART  (/RES), 
/NEXT_JOB  (/NE) ,  and  /TOP_OF_FILE  (PAsO)  are  appropriate  for  both 
print  and  batch  processors. 
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/BACKSPACES  ( : BA :n) 


Specifies  that  the  processor  start  n  pages  back  in  the  current 
job. 

/FORWARDSPACEin  ( :FW:n) 

Specifies  that  the  processor  start  n  pages  forward  in  the  current 
job. 

/PAGE : n  (:PA:n) 

Specifies  that  the  processor  start  at  specified  page  in  the 
current  job. 

These  page-related  qualifiers  have  meaning  for  print  processors 
only.  They  will  have  no  effect  unless  the  user  specified  a  page 
length  qualifier  in  the  PRINT  command. 

/ALIGN  (sAL) 


Informs  the  print  processor  that  the  paper  in  the  line  printer  is 
currently  at  the  top  of  a  form.  It  is  used  when  you  have  stopped 
the  print  processor  to  change  forms.  The  print  processor 
maintains  a  count  of  how  many  lines  it  has  gone  down  on  a  form. 
The  /ALIGN  (/AL)  qualifier  clears  that  count  for  new  forms. 

Examples 


DC L> START/ PR INTER  LPO 
MCR>QUE  LPO : /STA 

This  example  starts  print  processor  LPO:.  Printing  continues 
from  the  point  at  which  it  was  stopped. 


DC L> START/ PR INTER  LP0/FLAG:2 
MCR>QUE  LPO :/STA : FL : 2 

This  example  starts  print  processor  LPO:.  The  processor  will  put 
two  flag  pages  at  the  head  of  the  job  and  at  the  head  of  each 
file  if  the  user  specifies  flag  pages  in  a  PRINT  command. 


DCL>START/BATCH_PROCESSOR  BAPO 
MCR>QUE  BAPO : / STA 

This  example  starts  batch  processor  BAPO.  Batch  processing 
continues  from  the  point  at  which  it  was  stopped. 

DC L> START/ BATCH  BAPO/CONTINUE 
MCR>QUE  BAPO : /STA 
The  two  examples  are  equivalent. 
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DCL> START/ PR INTER  LP1/RESTART 
MCR>QUE  LPls/STAsRES 

This  example  starts  print  processor  LP1:.  The  job  active  at  the 
time  the  processor  was  stopped  is  restarted. 

Notes 

You  should  choose  with  care  between  the  /RESTART  (:RES)  and 
/CONTINUE  (MCR  default)  operations.  A  restart  may  conflict  with 
the  desires  of  users  with  print  or  batch  jobs  active  at  the  time 
a  processor  is  stopped. 

Users  can  specify  /NORESTART  (/-RES)  in  their  PRINT  or  SUBMIT 
commands.  If  a  print  or  batch  job  with  this  attribute  is  active 
when  the  processor  is  stopped,  and  you  start  the  processor  with 
the  /RESTART  (:RES)  qualifier,  you  will  be  restarting  the  jobs  at 
the  top  of  the  file  that  was  being  processed  when  the  processor 
was  stopped,  which  the  user  did  not  want  to  happen.  The 
/CONTINUE  (MCR  default)  qualifier  will  continue  such  jobs  as  the 
user  expected. 

If  you  are  restarting  a  processor  to  handle  special  forms,  you 
will  probably  want  to  set  the  /FLAGS  (:FL)  attribute  to  0  to 
avoid  having  a  banner  page  printed  on  your  special  forms. 


CHAPTER  8 


THE  SHUTUP  PROGRAM 


SHUTUP  is  the  system  program  that  enables  orderly  shutdo 
RSX-11M/M-PLUS  system.  SHUTUP  sends  warning  message 
nonpr ivileged  tasks ,  and  dismounts  devices  on  the  system. 


8.1  PREREQUISITES  TO  RUNNING  SHUTUP 

To  shut  down  a  system  using  SHUTUP,  the  following  tasks 
installed : 

•  INDIRECT,  the  MCR  Indirect  Command  Processor. 

•  ACS,  if  dynamic  checkpoint  space  is  established. 

•  BYE,  if  multiuser  protection  support  is  included. 

•  DMO,  if  there  are  any  mounted  devices. 


•  ELI,  if  error  logging  is  active. 


•  In  an  RSX-11M-PLUS  system  that  includes  Resource  Accounting, 
ACC  must  be  installed. 

If  LB : [1 , 2] SHUTUP. CMD  is  present,  you  may  want  it  to  install 
DMO,  ELI,  and  ACC.  See  Section  8.5. 

ACS,  BYE, 

8.2 

INVOKING  SHUTUP 

Invoke  SHUTUP  from  a  privileged  terminal  as  follows: 

>RUN  $SHUTUP dU 

On  RSX-11M  systems,  SHUTUP  displays  the  following  message  when 
invoked : 


RSX-11M  SHUT  DOWN  PROGRAM 

On  RSX— 1 1M-PLUS  systems,  SHUTUP  displays  the  following  mes 
invoked : 

RSX-11M-PLUS  SHUT  DOWN  PROGRAM 

sage  when 

wn  of  an 
s,  aborts 


must  be 
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8 . 3  SHUTUP  INPUT 

SHUTUP  prompts  for  the  number  of  minutes  to  wait  before  the  system  is 
to  be  shut  down,  between  warning  messages,  and  before  disabling 
logins.  If  you  specify  less  than  four  minutes  to  wait  before 
shutdown,  SHUTUP  does  not  ask  the  last  two  questions.  Instead,  SHUTUP 
sets  the  interval  between  messages  to  one  minute  and  disables  logins 
immediately. 

The  minutes  between  messages  must  be  greater  than  zero  and  less  than 
the  minutes  before  shutdown  minus  three.  If  you  specify  either  value 
incorrectly,  SHUTUP  rejects  your  answer  and  reprompts. 

The  following  is  an  example  of  SHUTUP  prompts  and  user  input: 

Enter  minutes  to  wait  before  shut  down:  15® 

Enter  minutes  between  messages:  3 (ret) 

Enter  minutes  to  wait  before  disabling  logins:  5® 

After  receiving  your  input,  SHUTUP  asks  for  confirmation  as  follows: 

OK  to  shutdown?  [Y/N] : 

SHUTUP  terminates  without  taking  any  action  if  your  response  to  the 
question  is  N.  If  your  response  is  Y,  SHUTUP  sends  warning  messages 
to  terminals.  Section  8.4  explains  the  messages. 


8 . 4  SHUTUP  OUTPUT 

SHUTUP  sends  warning  messages  to  terminals.  If  the  system  does  not 
support  multiuser  protection,  SHUTUP  sends  warning  messages  to  all 
terminals.  If  the  system  does  support  multiuser  protection,  SHUTUP 
sends  warning  messages  only  to  logged-in  terminals.  On  multiuser 
systems,  a  terminal  set  to  NOBROADCAST  receives  the  warning  messages 
only  during  the  last  five  minutes  before  shutdown. 

SHUTUP  sends  the  following  warning  messages: 

Please  finish  up,  15  minutes  before  shutdown  —  KERMIT 

Three  minutes  later,  SHUTUP  sends  another  message  as  a  result  of  the 
example  shown  in  Section  8.3.: 

Please  finish  up,  12  minutes  before  shutdown  —  KERMIT 

The  messages  include  a  six-character  name  that  is  a  DECnet  node  name 
(if  DECnet  is  active)  or  the  system  name  that  was  selected  in  SYSGEN 
(if  DECnet  is  not  active).  In  the  previous  messages,  KERMIT  is  the 
six-character  name. 

SHUTUP  continues  to  issue  the  warning  messages  at  the  interval 
specified.  When  three  minutes  remain  before  system  shutdown,  SHUTUP 
changes  the  interval  between  messages  to  one  minute. 
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If  the  system  supports  multiuser  protection  and  the  specified  delay 
before  disabling  logins  has  expired  (measured  from  the  time  SHUTUP  is 
started) ,  SHUTUP  displays  the  following  message  on  the  invoking 
terminal  : 

All  further  logins  are  disabled 

After  SHUTUP  logs  off  all  terminals,  aborts  all  nonpr ivileged  tasks, 
and  dismounts  all  devices,  it  displays  the  following  message  on  the 
invoking  terminal  : 

SHUTUP  operation  complete 

SHUTUP  then  halts  the  processor. 

At  this  point,  you  can  either  boot  another  system  or  resume  operation 
of  the  current  system  by  pressing  the  Continue  switch  on  the  CPU 
console.  After  you  press  the  CONT  switch  (continue) ,  logins  are 
enabled  and  the  following  message  appears  on  the  invoking  terminal  2 

Logins  are  now  enabled 

To  continue  operation  of  the  current  system,  you  must  mount  the 
devices  and  follow  normal  system  start-up  procedures. 


8.5  THE  SHUTUP.CMD  FILE 

The  indirect  command  file  LB : [1 , 2] SHUTUP. CMD  is  for  user-specific 
functions.  SHUTUP  submits  the  file,  if  present,  to  the  Indirect 
Command  Processor  for  execution.  The  SHUTUP  task-build  file  specifies 
the  amount  of  time  (the  timeout  interval)  that  SHUTUP.CMD  has  to 
execute.  The  default  timeout  interval  is  120  seconds  or  170(8).  It 
is  possible  to  change  the  timeout  interval  for  SHUTUP.CMD  in  the 
task-build  file. 

On  unmapped  RSX-11M  systems,  the  task  build  file  is  [ 1 , 20] SHUBLD. CMD. 
On  mapped  RSX-11M  systems,  the  file  is  [ 1 , 24 ] SHUBLD. CMD. 

For  RSX-1 1M-PLUS  systems,  the  task-build  file  is  [ 1 , 24] SHUBLD. CMD. 

If  the  timeout  interval  expires  and  SHUTUP.CMD  is  not  finished,  SHUTUP 
asks  if  you  want  to  wait  for  SHUTUP.CMD  to  finish.  For  example: 

Command  (AT.)  Timeout  -  Continue  waiting?  [Y/N] : 

If  you  enter  N,  SHUTUP  continues  without  waiting  any  longer.  If  you 
enter  Y,  SHUTUP  waits  an  additional  30  seconds.  SHUTUP  continues 
without  waiting  any  longer  if  SHUTUP.CMD  has  not  finished  at  the  end 
of  the  30  seconds. 

You  may  want  SHUTUP.CMD  to  install  ACS,  BYE,  DMO,  ELI,  and  ACC  (these 
tasks  must  be  installed  to  enable  SHUTUP  to  execute  properly) .  If 
DECnet  is  installed  in  your  system,  you  may  use  SHUTUP.CMD  to  shut 
down  the  network. 


8-3 


THE  SHUTUP  PROGRAM 


The  following  is  an  example  of  a  SHUTUP.CMD  file: 

;THIS  SHUTUP.CMD  FILE  INSTALLS  ELI 
; AND  ACS  IF  THEY  ARE  NOT  INSTALLED, 

; AND  ALSO  ACTIVATES  A  COMMAND  FILE  TO 
;SHUT  DOWN  THE  NETWORK  IF  THE  NETWORK 
; IS  ACTIVE. 

} 

.ENABLE  SUBSTITUTION 

.IFNINS  ...ELI  INS  $ELI 
. IFNINS  ...ACS  INS  $ACS 

.IFNACT  NETACP  .GOTO  20 
@LB : [1,2] NETSTOP 


.  20: 


8.6  RSX-11M  SYSTEM  SHUTDOWN 

The  following  sections  describe  the  shut-down  procedure  for  RSX-11M 
systems.  An  annotated  example  of  a  system  shutdown  supplements  the 
description . 

8.6.1  RSX-11M  System  Shutdown  Procedure 

When  the  delay  before  system  shutdown  expires,  SHUTUP  performs  the 
following  functions: 

1.  Logs  off  logged-in  terminals  (multiuser  protection  systems 
only)  . 

2.  Stops  the  Console  Logger  (if  active). 

3.  Redirects  the  console  terminal  to  the  TI:  of  SHUTUP. 

4.  If  the  indirect  command  file  LB : [1 , 2] SHUTUP. CMD  is  present, 
submits  it  to  the  Indirect  Command  Processor  for  execution. 

5.  Stops  the  Queue  Manager  (if  active). 

6.  Stops  the  Error  Log  Task  ( ERRLOG)  (if  active)  . 

7.  Deallocates  checkpoint  space  and  dismounts  devices. 

8.  Halts  the  processor. 

At  this  point,  you  can  either  boot  another  system  or  resume  operation 
of  the  current  system. 
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8.6.2  Example  of  an  RSX-11M  System  Shutdown 

The  following  is  an  example  of  an  RSX-11M  system  shutdown: 


> RUN  $SHUTUP 

RSX-11M  SHUT  DOWN  PROGRAM 

Enter  minutes  to  wait  before  shutdown*  1 0  (ret) 

Enter  minutes  between  messages*  3  (ret) 

Enter  minutes  to  wait  before  disabling  logins*  5  (ret) 
OK  to  shutdown?  CY /Hit  Y © 


1 7-FEB-8 1 

16535  Please 

finish 

UP  > 

10 

minutes 

before 

shutdown 

—  QUASAR 

1 7-FEB-8 1 

16538  Please 

finish 

UP  f 

7 

minutes 

before 

shutdown 

—  QUASAR 

All  further  logins  are 

disabled 

17-FEB-81 

16540  Please 

finish 

UP  J 

5 

minutes 

before 

shutdown 

—  QUASAR 

1 7-FEB-8 1 

16542  Please 

finish 

UP  f 

3 

minutes 

before 

shutdown 

—  QUASAR 

1 7-FEB-81 

16543  Please 

finish 

UP  1 

2 

m i nutes 

before 

shutdown 

—  QUASAR 

1 7-FEB-8 1 

16544  Please 

finish 

UP  t 

1 

minute 

before 

shutdown 

--  QUASAR 

17-FEB-81 

16545  System 

i  s  now 

shutting  down  - 

-  QUASAR 

SET  /COLQG=OFF  Q 

0LB5C1>23SHUTUP  © 

>INS  $EL I 
>INS  $ ACS 
>0  <EOF> 

QUE  /STO 5 QhG  © 

ELI  /N0L06  O 

16*46501  ERRLOG  Error  Logging  stopped 
ACS  hbo;/blks=o.  © 

ACS  --  Checkpoint  file  now  inactive 
DMO  DBOS/DEV  © 

> 

DMO  --  System  disk  being  dismounted 

DMO  --  SYSTEM  dismounted  from  DB05  ***  Final  dismount  initiated  *** 
16*47*10  ***  DB05  ~~  Dismount  complete 

> 

DHO  DSO 5 /DEV  © 

DMO  —  Warning  -  Tasks  installed  from  DS05 

DMO  —  SYSTEM  dismounted  from  DS05  Final  dismount  initiated  *** 

16*47*20  ***  DSO*  —  Dismount  complete 

\ 

x 

SHUTUP  operation  complete  © 
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To  shut 

down  the  system  in  this  example,  SHUTUP: 

o 

Stops  the  Console  Logger. 

0 

Invokes  the  indirect  command  file  LB :[ 1 , 2] SHUTUP. CMD. 

SHUTUP • CMD  installs  ELI  and  ACS.  The 

indicates  the  end  of  the  command  file  SHUTUP 

@<EOF>  message 

.CMD. 

© 

Stops  the  Queue  Manager. 

© 

Runs  the  task  ELI  to  terminate  the  Error  Log 

Task  (ERRLOG) . 

0 

Deallocates  checkpoint  files  on  DBO:. 

© 

Dismounts  the  disks  on  DBO:  and  DSO:. 

0 

Displays  a  message  when  SHUTUP  has  finished 

executing . 

8.7 

RSX-11M-PLUS  SYSTEM 

SHUTDOWN 

The 

following  sections 

describe 

the 

shut-down 

procedure 

for 

RSX-1 1M-PLUS  systems.  An  annotated  example  of  a  system  shutdown 
supplements  the  description. 

8.7.1  RSX-11M-PLUS  System  Shutdown  Procedure 

When  the  delay  before  system  shutdown  expires,  SHUTUP  performs  the 
following  functions : 

1.  Stops  the  Console  Logger  (if  active). 

2.  Redirects  the  console  terminal  to  the  TI:  of  SHUTUP. 

3.  If  the  indirect  command  file  LB : [ 1 , 2] SHUTUP. CMD  is  present, 
submits  it  to  the  Indirect  Command  Processor  for  execution. 

4.  Logs  off  logged-in  terminals  (multiuser  protection  systems 
only)  . 

5.  Stops  the  Queue  Manager  (if  active). 

6.  If  Resource  Accounting  is  active,  stops  Resource  Accounting. 

7.  Stops  the  Error  Log  Task  ( ERRLOG)  (if  active). 

8.  Checkpoints  all  read/write  commons. 

9.  Deallocates  checkpoint  space  and  dismounts  devices. 

10.  Halts  the  processor. 

At  this  point,  you  can  either  boot  another  system  or  resume  operation 
of  the  current  system. 
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8.7.2  Example  of  an  RSX-M-PLUS  System  Shutdown 

The  following  is  an  example  of  an  RSX-11M-PLUS  system  shutdown: 


>R UN  $SHUTUP 

RSX-l  1M--PLUS  SHUT  DOWN  PROGRAM 

Enter  minutes  to  wait  before  shutdown*  10® 

Enter  minutes  between  messages*  5  ® 

Enter  minutes  to  wait  before  disabling  logins*  2® 

OK  to  shutdown?  CY/Nlt  Y® 

05-MAR-81  16*34  Please  finish  up>  10  minutes  before  shutdown  --  CASTOR 


All  further  logins  are  disabled 


05-MAR--81 

16*39 

Please 

finish 

UP* 

5 

minutes 

before 

shutdown 

--  CASTOR 

05-MAR-8 1 

16*41 

Please 

finish 

UP  t 

3 

minutes 

before 

shutdown 

~~  CASTOR 

05-MAR-81 

16*42 

Please 

finish 

UP  ? 

9 

m i notes 

before 

shutdown 

—  CASTOR 

05-MAR-8 1 

1 6  M3 

Please 

finish 

UP  * 

1 

minute 

before 

shutdown 

~~  CASTOR 

05-MAR-81 

16*44 

System 

is  n o w 

shutting  down  - 

-  CASTOR 

@LB ♦ C 1 >2!SHUTUP  Q 
>INS  $EL I 
> I NS  $ACS 
>e  <E0F> 

QUE  /ST0:QM6  © 

*s. 

ST0P/ACC0UNTIN6  SHUTUP  © 

> 

ELI  /NOLOG  © 

16*50*20*  ERRLOG  Error  Logging  stopped 

V, 

ACS  DB7  * /BLKS=0  *  © 

ACS  --  Checkpoint  file  now  inactive 
DM0  DB7  5 /DE0/L0CK=V  © 

)“ 

DM0  System  disk  being  dismounted 

DM0  --  SYSTEM  dismounted  from  DB7*  ***  Final  Dismount  Initiated  tt* 
16*47*19  ***  DB7*  --  Dismount  complete 

v 

/ 

SHUTUP  operation  complete  Q 


To  shut  down  the  system  in  this  example ,  SHUTUP: 

0  Invokes  the  indirect  command  file  LB : [ 1 , 2] SHUTUP. CMD. 

SHUTUP.CMD  installs  ELI  and  ACS,  The  @<EOF>  message 
indicates  the  end  of  the  command  file  SHUTUP.CMD. 
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©  Stops  the  Queue  Manager. 

©  Stops  Resource  Accounting. 

©  Runs  the  task  ELI  to  terminate  the  Error  Log  Task  (ERRLOG) . 

©  Deallocates  checkpoint  files  on  DB7:. 

©  Dismounts  the  disk  on  DB7:. 

The  Virtual  option,  /LOCK=V,  is  privileged.  When  you  specify 
the  Virtual  option,  the  DISMOUNT  command  does  not  clear 
volume  as  valid  and  does  not  spin  down  the  disk.  (Refer  to 
the  RSX-1 1 M/M— PLUS  MCR  Operations  Manual  for  additional 
info rmation.) 

©  Displays  a  message  when  SHUTUP  has  finished  executing. 
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USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 


The  User  Environment  Test  Package  (UETP)  verifies  the  integrity  and 
operation  of  a  newly  generated  RSX-1 1M/M-PLUS  system.  The  program 
consists  of  several  Indirect  command  files  that  verify  the  presence 
and  operation  of  devices,  test  the  basic  Executive  features,  and 
verify  the  presence  of  system  utilities. 

UETP  does  not  replace  the  hardware  diagnostic  tests  that  DIGITAL  Field 
Service  performs  on  your  devices  nor  does  it  substitute  for  software 
testing  during  software  development.  UETP  only  verifies  that  your 
system  generation  has  produced  a  working  operating  system  with  the 
configuration  you  intended. 


9.1  STRUCTURE  OF  THE  UETP 

UETP  consists  of  seven  modules:  five  test  modules,  an  initialization 
module,  and  a  cleanup  module.  During  initialization,  the  program 
allows  you  to: 

•  Select  the  number  of  times  you  wish  to  run  UETP 

•  Select  which  of  the  five  tests  you  wish  to  run 

•  Include  or  omit  extended  comments  at  the  start  of  each  test 

•  Exclude  devices  from  testing 

UETP  time-stamps  the  start  and  end  of  the  output  for  each  test  module. 
If  a  module  cannot  run  because  of  any  of  the  restrictions  discussed  in 
Sections  9.1.1  and  9.1.2,  UETP  outputs  an  error  message. 

The  five  test  modules  are: 

•  Load  Test 

•  I/O  Exerciser  Test 


•  Utilities  Test 

•  MCR  Command  Test 

•  Interactive  Utilities  Test 

Each  of  these  test  modules  is  discussed  briefly  in  the 
sections . 


fol lowi ng 
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9.1.1  The  Load  Test 

The  Load  Test  exercises  the  multitasking  and  multiprogramming 
capabilities  of  your  system.  The  Load  Test: 

•  Determines  whether  the  memory  encompassed  by  the  system 
partition,  GEN,  is  available  to  the  system 

•  Uses  the  Send  and  Receive  Executive  Directives 

•  Tests  swapping  and  round-robin  scheduling  if  they  are  present 
in  your  system 

On  RSX-11M  systems,  your  system  must  support  all  of  the  following 
features  to  enable  the  Load  Test  to  run: 

•  ASTs 

•  Memory  mapping 

•  Send/Receive  directives 

•  Alter  Priority  directive 

•  Get  Partition  Parameters  directive 

•  Dynamic  checkpointing 

UETP  determines  the  presence  of  these  features.  It  outputs  a  message 
to  your  terminal  if  the  Load  Test  cannot  be  run  because  one  or  more  of 
these  features  is  not  present. 


9.1.2  The  I/O  Exerciser  Test 

This  test  runs  the  I/O  Exerciser  (IOX),  which  is  a  software  tool  for 
detecting  and  diagnosing  I/O  problems  on  the  disk  and  tape  units  in 
your  system's  hardware  configuration.  IOX  performs  I/O  testing  on 
disks,  magnetic  tapes,  cassettes,  and  DECtapes.  IOX  exercises  disk 
and  tape  units  that  have  recording  media  in  place  and  are  not 
allocated  to  other  users.  If  units  are  not  mounted,  IOX  mounts  them. 

IOX  destroys  the  contents  of  tapes  and  nonfile-structured  disks  during 
testing.  IOX  exercises  Files-11  disks  without  destroying  their 
contents,  because  IOX  creates  and  deletes  its  own  files  during 
testing . 

For  RSX-11M  systems,  the  I/O  Exerciser  can  only  test  systems  that 
support  ASTs. 


9.1.3  The  Utilities  Test 

This  test  invokes  some  of  the  RSX-1 1M/M-PLUS  utilities:  CMP,  FLX , 
DMP ,  CREF,  PMD,  PRT ,  DSC,  PAT,  SLP,  and  LBR .  It  verifies  their 
presence  and  performs  a  simple  test  of  their  functions. 
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9.1.4  The  MCR  Command  Test 

This  module  tests  some  of  the  MCR  disk-access  commands:  ALL ,  DEA, 

MOU ,  DMO ,  INI ,  UFD ,  and  VFY  and  the  BAD  utility. 


9.1.5  The  Interactive  Utilities  Test 

This  test  invokes  EDI ,  EDT,  ZAP,  and  ACNT.  You  must  be  present  at  the 
terminal  from  which  the  UETP  is  running  to  exit  from  the  interactive 
utilities  that  this  test  module  invokes. 


9.2  OPERATING  ENVIRONMENT 

You  run  UETP  following  system  generation.  To  ensure  the  integrity  of 
the  testing,  UETP  should  have  unlimited  access  to  all  system  features 
and  devices.  You  should  therefore  run  UETP  on  a  stand-alone  basis  for 
two  reasons:  (1)  users  may  change  the  state  of  the  system,  thereby 
invalidating  or  modifying  the  results  of  UETP  and  (2)  UETP  puts  a 
heavy  load  on  the  system,  which  may  interfere  with  other  work  on  the 
system. 


To  run  the  UETP,  you  need  only  one  terminal.  It  must  be  a  privileged 
terminal.  It  is  best  to  run  the  program  from  a  hard-copy  terminal  so 
that  you  have  a  record  of  any  error  messages  generated  during  the 
execution  of  UETP.  If  you  have  a  second  terminal  that  is  a  CRT 
terminal,  you  can  use  it  to  run  the  Memory  Display  of  RMD  which 
monitors  how  the  system  memory  is  being  allocated  while  UETP  is 
executing.  This  is  particularly  useful  during  the  Load  Test. 


For  RSX-11M  systems,  the  command  files  that  comprise  UETP  are  located 
in  UFD[2,300]  on  one  of  the  disks  in  your  system  as  follows: 


Disk  Type 

Big  Disks 
RP04/05/06 
RM02/03 

RK06/07 

RL01/RL02 

RK05 


Volume  Label 


RSXM32 

RSXM32 

CLI SRC 
HLPDCL 

HLPSYS 


For  RSX-1 1M-PLUS  systems,  the  command  files  that  comprise  UETP  are 
located  in  UFD[2,300]  on  the  disk  labeled  RSX11MPBL10. 

For  RSX-11M  systems  on  RL01/RL02  and  RK05  kits,  you  must  have 
completed  SYSGEN  Phase  III  to  build  the  nonpr ivi 1 eged  tasks  that  you 
want  UETP  to  test.  These  tasks  are  tested  in  the  Utilities  Test,  the 
MCR  Command  Test,  and  the  Interactive  Utilities  Test  (see  Sections 
9.1.3  through  9.1.5  for  a  list  of  these  tasks).  You  must  have  also 
built  IOX  if  you  want  to  run  the  I/O  Exerciser  Test. 


To  run  the  Utilities  Test,  you  must-have  a  scratch  disk  or  DECtape. 
To  run  the  MCR  Command  Test,  you  must  have  a  scratch  disk.  To  run  the 
DSC  in  the  MCR  Command  Test  module,  you  must  have  a  floppy  disk  or 
DECtape . 

The  utilities  BAD,  TKB ,  and  MAC  must  be  present  on  the  system  disk  or 
already  installed  for  UETP  to  run. 


9-3 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 


9.3  OPERATING  PROCEDURES 

Before  running  the  UETP,  create  the  necessary  operating  environment  as 
described  in  Section  9.2.  After  you  log  in  on  the  privileged  terminal 
from  which  you  wish  to  run  UETP  do  the  following: 

1.  Place  scratch  media  on  all  DECtape,  cassette,  floppy,  and 
magnetic  tape  drives  that  you  want  to  test.  Place 
initialized  Files-11  disk  packs  on  all  disk  drives  that  you 
want  to  test.  The  I/O  Exerciser  Test  destroys  data  on  the 
nonfile-structured  disks  and  tapes;  therefore  you  must  use 
scratch  media.  IOX  does  not  destroy  data  on  Files-11  hard 
disks;  therefore  they  need  not  be  scratch  disks. 

2.  Assign  your  system  disk  to  LB:  by  typing 

> ASN  ddnn : =LB : 

ddnn: 

Logical  device  name  of  your  system  disk. 

3.  For  RSX-11M  systems  that  do  not  have  a  big  disk,  the  system 
disk  and  the  disk  containing  the  UETP  files  are  not  the  same. 
If  your  system  disk  has  enough  free  blocks  to  accommodate  all 
the  UETP  command  files  plus  300  to  400  additional  blocks  for 
files  that  UETP  creates,  then  you  may  want  to  copy  the  UETP 
files  to  your  system  disk. 

Assign  the  disk  that  contains  the  UETP  files  to  SY:  by 

typing 

>ASN  ddnn:=SY: 

ddnn: 

Logical  device  name  of  the  disk  that  contains  the  UETP 
files . 

4.  Allocate  generous  checkpoint  space  for  the  system  (about  512 
blocks)  by  typing 

>ACS  SY : /BLKS=5 1 2 . 

5.  Execute  the  UETP.CMD  command  file  by  typing 

>@[2,300] UETP 


9.4  ERROR  REPORTING 

Tasks  that  detect  errors  may  output  error  messages  to  your  terminal. 
IOX  does  its  own  error  reporting.  Tasks  that  run  during  the  MCR 
Command  Test,  the  Utilities  Test,  and  the  Interactive  Utilities  Test 
output  their  own  error  messages. 
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rate  error 
format  for 


The  DEFINE  task,  which  gets  the  system  configuration  information  for 
UETP ,  and  some  of  the  tasks  that  comprise  the  Load  Test  gene 
messages.  For  the  most  part,  these  tasks  use  the  following 
error  messages: 

taskname  ERROR  nn  ccc 
taskname 

Name  of  the  task  that  caused  the  error. 


nn 


Error  number  specific  to  that  task  (defined  in  the 
sections  for  each  task) . 


following 


ccc 

Low  byte  in  octal  of  the  $DSW  for  Executive  Directive  errors  or 
F.ERR(RO)  for  FCS  errors.  (For  more  information  on  the  $DSW,  see 
the  RSX-1 1 M/M- PLUS  Executive  Reference  Manual.  For  more 
information  on  F. ERR (RO )  ,  see  IAS/RSX-11  I/O  Operations  Reference 
Manual . ) 

The  error  numbers  for  each  task  identify  which  kind  of  macro 
instruction  caused  the  error.  These  are  either  FCS  macros  or 
Executive  Directive  macros. 


9.4.1  The  System  Configuration  Module  (DEFINE. TSK) 

The  error  messages  for  the  system  configuration  module,  DEFINE. TSK, 
are  as  follows: 


Error  No.  Macro 


Explanation 


1 

2 

3 

4 

5 

6 
8 

19 


OPEN$W  Open  to  create  CONFIG.CMD  file  failed. 

OPEN$R  Open  file  TAILOR • DAT  for  read  ( FDB=FDTAIL)  failed. 

READS  Read  of  file  TAILOR • DAT  failed  (FDB=FDTAIL) . 

WAITS  Wait  for  file  TAILOR • DAT  ( FDB=FDTAIL)  failed. 

CLOSES  Close  of  file  TAILOR • DAT  ( FDB=FDTAIL)  failed. 

CLOSES  Close  failed  for  CONFIG.CMD  file. 

PUTS  Output  to  CONFIG.CMD  file  failed. 

EXITSS  Exit  failed. 


9.4.2  The  Monitoring  Task  for  QT  Load  Task  (LOGGER. TSK) 


The  error  messages  for  the  monitoring  task 
LOGGER. TSK,  are  as  follows: 


for  QT  Load  Task, 


Error  No.  Macro 


Explanation 


1 

2 


OPEN$W 

OPEN$W 


Failure  of  open  for  write 
Failure  of  open  for  write 


to  RUNLOG.DAT  file, 
to  ERRLOG.DAT  file. 
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3 

PUT$ 

4 

PUT$ 

5 

PUT$ 

6 

PUT$R 

7 

WSIG$S 

10 

RCVD$C 

11 

ALUN$S 

12 

WTSE$C 

13 

SETF$S 

14 

SDAT$S 

15 

CLOSES 

16 

GTIM$C 

17 

CLEF$S 

Failure  of  write  to  ERRLOG.DAT  or  RUNLOG.DAT  file. 
Failure  of  write  to  ERRLOG.DAT  file. 

Failure  of  write  to  ERRLOG.DAT  or  RUNLOG.DAT  file. 
Failure  of  write  to  RUNLOG.DAT  or  ERRLOG.DAT  file. 
Wait  for  Significant  Event  directive  failure. 
Receive  Data  directive  failure. 

Assign  LUN  directive  failure. 

Wait  for  Significant  Event  directive  failure. 

Set  Event  Flag  directive  error. 

Send  Data  Directive  failure. 

Close  failure  of  RUNLOG.DAT  or  ERRLOG.DAT  file. 

Get  Time  directive  failure. 

Clear  Event  Flag  directive  failure. 


9.4.3  The  Startup  QT  Load  Task  (QTRUN.TSK) 


The  error  messages  for  the  Startup  QT  Load  Task,  QTRUN.TSK,  are  as 
follows : 


Error  No.  Macro 


Explanation 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

13 

14 

15 

16 

17 

18 

19 

20 
21 

22 


0PEN$W 

0PEN$R 

READ$ 

WAIT$ 

CL0SE$ 

CL0SE$ 

GPRT$C 

PUT$ 

RSUM$S 

RQST$S 

WSIG$S 

RSUM$S 

RQST$S 

SDAT$S 

SDAT$S 

RSUM$S 
EXI T$S 
GTIM$C 
ALTP$C 

MRKT$C 


Open  failure  on  DVLREM.CMD  or  DVLSET.CMD  file. 

Open  failure  on  TAILOR . DAT  file. 

Read  failure  on  TAILOR . DAT  file. 

Wait  failure  on  TAILOR . DAT  file. 

Close  failure  on  TAILOR . DAT  file. 

Close  failure  on  DVLSET.CMD  file  or  DVLREM.CMD  file. 

Get  Partition  Parameters  Executive  directive  failure. 
Write  failure  for  • CMD  files  created  by  QTRUN. 

Resume  Executive  directive  failure  for  DUMMY  task. 
Request  Executive  directive  failure  for  LOGGER  task. 
Wait  for  Significant  Event  Executive  directive  failure. 
Resume  Executive  directive  failure. 

Request  Executive  directive  failure. 

Send  Data  Executive  directive  failure 
(failure  of  Send  Data  to  QT  task). 

Send  Data  Executive  directive  failure 
(failure  of  Send  Data  to  LOGGER  task). 

Resume  Executive  directive  failure. 

Exit  Executive  directive  failure. 

Get  Time  Executive  directive  failure. 

Alter  Priority  Executive  directive  failure 
(alteration  of  Indirect  command  file  priority  failed). 
Mark  Time  Executive  directive  failure. 


9.4.4  The  NUL1  Form  of  the  QT  Load  Task  (NUL1.TSK) 

The  error  reporting  format  for  NUL1.TSK  differs  from  the  general  error 
reporting  format.  When  a  directive  error  occurs,  the  QT  Load  Task 
prints 

TASK  QTnn  ABORTING 

where  "nn"  is  the  task  number  that  identifies  the  task  that  caused  the 
error . 


9-6 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 


The  error  number  is  then  displayed  as 
ERROR  xx 

where  "xx"  corresponds  to  one  of  the  error  conditions  described  in  the 
following  table. 

After  displaying  the  error  number ,  the  task  displays  the  $DSW. 


Error  No.  Macro 


Explanation 


0 

1 

3 

4 

5 

6 
7 


8 

12 


SPND$S  Suspend  directive  issued  by  QT  Load  Task  failed. 

RCVD$C  Receive  Data  directive  failed  (receive  from  CONFIG) . 

ALUN$S  Assign  Logical  Unit  Number  directive  failure  to  use 

TT  number  received  from  CONFIG. TSK. 

MRKT$C  Mark  time  directive  failure. 

EXIF$S  Exit  directive  failure. 

DSCP$S  Disable  Checkpointing  directive  failure. 

SDAT$S  Send  Data  directive  failure  (send  to  LOGGER  before 

exiting) .  Insufficient  dynamic  memory  can  cause 
this  error. 

ASTX$S  AST  Service  Exit  directive  failure. 

CLEF$C  Clear  Event  Flag  directive  failure. 


9.5  SAMPLE  UETP  CONSOLE  DIALOG 

The  console  dialog  in  Example  9-1  is  from  a  session  of  running  the 
UETP  on  an  RSX-11M  system. 


On  RSX-1 1M-PLUS  systems,  mount  all  scratch  disks  using  the  /FOREIGN 
switch  for  the  MOUNT  command.  Mount  all  tapes. 


Example  9-1  Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 

>  asn  dl:=lb: 

>  ASN  DLii=SY: 

> ACS  SY:/BLKS=512* 

> 

>(?C2  f  3003UETP 

>  f  DISK  =  DL:  UIC  =  C2  f  3003 
> S E T  /UIC  =  C2  f  3003 
>?***#*  THINKING  ***** 

> f  NEEDED  UTILITIES  WILL  BE  INSTALLED  NOW* 

> I N S  LB*$MAC/CKP=YES 
>1  NS  LB!*TKB/CKP=YES 

> ins  lb:*cmp/ckp=yes 
>ins  lb:*lbr/ckp=yes 
>ins  lb:$pip/ckp=yes 
>i ns  lb:*edi/ckp=yes 

>  F 

>i  ******************************************************************* 

>  F  *  * 

>F  *  RSX-1 1 M  U4* 0  UETP  PROCEDURE  STARTED  AT  13t57:34  ON  20-JUL-81  * 

>f  *  * 

>;  ******************************************************************* 

y  f 

>*  ENTER  NUMBER  OF  PASSES  FOR  UETP  CO  RJ1-100  DJ1DJ  1 

>  F 

>*  RUN  LOAD  TEST?  CY/NDt  Y 

>  F 

(continued  on  next  page) 
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Example  9-1  (Cont.)  Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 

>*  RUN  10  EXERCISER?  CY/N3J  Y 
y  9 

>*  RUN  UTILITIES  TEST?  CY/ND ♦  Y 

>  t 

>*  RUN  MCR  COMMAND  TEST?  CY/ND ♦  Y 

> » 

>*  RUN  INTERACTIVE  UTILITIES  TEST?  CY/ND:  Y 

>  9 

>*  EXTENDED  COMMENTS  DESIRED?  CY/ND t  Y 

>  9 

>*  IF  PRESENT 9  ACTIVATE  ERROR  LOGGER?  CY/NDt  Y 

>a9 

>9 

>*  DO  YOU  WISH  TO  RUN  RMDEMO?  CY/ND ♦  Y 

>9 

>*  ENTER  TERMINAL  NUMBER  FOR  RMDEMO  COD!  2 

>; 

>INS  LB:$RMD/TASK=T2RMD 
>REA  T2RMD  1  TT2  ♦ 

>REA  T2RMD  2  TT2  ♦ 

>RUN  T2RMD 
>EL I  /LOG 

ERRLOG  Error  Logging  initialized 

>f 

>*  PAUSE  INITIALIZE  DISKS  OR  MOUNT  TAPES?  CY/ND4*  Y 

>  9 

♦♦♦AT*  —  Pausing*  To  continue  type  "UNS  ♦**AT*<ESC>* 


>ALL  MMO: 

>ALL  DMO t 
>MOU  DMO ♦ /OVR 
>ALL  DKO ♦ 

>MOU  DKOt/OVR 

>UNS  ♦ ♦ ♦ AT ♦ 


♦♦♦AT*  --  Continuing 


>MAC  0UETPASM 
>TKB  0UETPBLD 

> MAC  DEFINE  =  LB:CU  f 10DRSXMC/PAJ1 * SY4*C2> 3001 DEFINE 

>TKB  DEFINE /PR /CP =DEFINEfLB*Cl*54DRSXllM*STB>ClflDEXELIB/LB 

>PIP  NUL1 ♦ OBJ  * *>NUL2. OBJ  * *>NUL3* OBJ **, LOGGER* OBJ  ** ,GTRUN* OBJ **/DE/NM 

>PIP  DUMMY* OBJ f */DE* DEFINE  *  OBJ DAT  9% 9 ERRLOG *LST 9 */NM 

>PIP  CRTEST*LST» 1 /DE , CRTEST *  OB J > 1 /DE , CRTEST * TSK 5 1/DE/NM 

>PIP  ***/PU 

>INS  DEFINE/TASK= DEFINE 
>PIP  TAILOR* DAT=DEVM*SAM/AP 
>RUN  DEFINE 


>  9 

>9  THESE  ARE  THE  DEVICES  INCLUDED  IN  YOUR  SYSTEM 

>9 


>  DEV 

IPOJ  OFFLINE  UNLOADED 
UDO:  OFFLINE 
XMO ♦  OFFLINE  LOADED 
XPO:  OFFLINE  LOADED 
XGO:  OFFLINE  LOADED 
LPO:  OFFLINE  LOADED 


(continued  on  next  page) 
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Example  9-1  (Cont.)  Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 


DRO l  LOADED  TYPE=RP04 

DKOJ  TTO:  -  PRIVATE  MOUNTED  LOADED  LABEL=TESTA 

DLO:  PUBLIC  MOUNTED  LOADED  LABEL=RSXM32  TYPE=RL01 

DL1J  MOUNTED  LOADED  LABEL=HLPDCL  TYPE=RL01 

DMO l  TTO  ♦  -  PRIVATE  MOUNTED  LOADED  LABEL  =  TESTB  TYPE=RK06 

DM1 :  LOADED  TYPE=RK06 

DYO:  OFFLINE  LOADED  TYPE=RX02 

DY1S  OFFLINE  LOADED  TYPE=RX02 

MMO:  TTO:  -  PRIVATE  LOADED 

COOS  TTOS 

TTOS  C2  *  3003  -  LOGGED  ON  LOADED 

TT1S  LOADED 

TT2S  LOADED 

TT3S  LOADED 

TT 4 S  LOADED 

TT5S  LOADED 

TT6S  LOADED 

TT7S  LOADED 

TT10S  LOADED 

NLOS 

TIOS 

CLOS  TTOS 
LBOS  DLO  S 

SYOS  DLO  S 

>* 

>9  IF  YOU  DO  NOT  WISH  TO  TEST  OR  DO  NOT  HAVE  MEDIA  FOR  ANY 
>*  OF  THE  ONLINE  DEVICES  *  SPECIFY  THEM  NOW  (ONE  AT  A  TIME) 

>*  TYPE  <CR>  WHEN  FINISHED ♦ 

>  9 

>*  SPECIFY  TAR£  OR  DISK  TO  BE  EXCLUDED  CS3J  DB 

>*  SPECIFY  TAPE  OR  DISK  TO  BE  EXCLUDED  CS3S  DM1 

>*  SPECIFY  TAPE  OR  DISK  TO  BE  EXCLUDED  C S3  S  (ret) 

>; 

>  * 

>*  TO  RUN  THE  MCR 9  FLX*  AND  DSC  TESTS  AT  LEAST  ONE  SCRATCH  DISK  (OR 

>9  DECTAPE)  MUST  BE  SPECIFIED ♦  ENTER  SCRATCH  DISK(S>*  AND  TYPE 

>9  <CR>  WHEN  FINISHED ♦ 

>** 

>#  SPECIFY  A  SCRATCH  DISK  CS3S  DK 

>*  THE  CONTENTS  OF  DKO  WILL  BE  LOST  !!  APPROVE  ?  CY/N3J  Y 
>*  SPECIFY  A  SCRATCH  DISK  CS3J  ® 

>i 

>9  *  LOAD  TEST  STARTED  AT  14!27!24  * 

>  9 

>9  FOR  THE  NEXT  FEW  MINUTES  A  NUMBER  OF  COMPUTE-BOUND  TASKS  WILL  BE 
>f  EXERCISING  THE  MULTI-TASKING  CAPABILITIES  OF  THE  SYSTEM* 

>9  AND*  IF  INCLUDED  IN  THIS  SYSTEM*  THE  ROUND-ROBIN  SCHEDULER* 

>*  THE  SHUFFLER  AND  CHECKPOINTING ♦  THE  ACTION  OF  THESE  LAST  THREE 
>*  FEATURES  CAN  BE  SEEN  ON  THE  RMDEMO  SCREEN.  IF  THE  SYSTEM  IS 
>*  PERFORMING  PROPERLY*  ALL  OF  THE  "GEN*  PARTITION  IS  USED  AND  THE  "GT" 
>*  TASKS  ARE  SHARING  SYSTEM  RESOURCES  IN  A  MANNER  CONSISTENT 

>  *  WITH  THE  FEATURES  AVAILABLE.  NOTE  THAT  CHECKPOINTING  IS  DISABLED 
>*  FOR  THE  SECOND  HALF  OF  THE  TEST. 

>* 

>i  ***  THIS  TEST  RUNS  FOR  A  MAXIMUM  OF  6  MINUTES  *** 

>i 

>INS  DUMMY/TASK=DUM00/PRI=40. 

>INS  LOGGER/ T ASK =LOGOO 
>INS  QTRUN  /TASK=QTROO 


(continued 


on 


next  page) 
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Example  9-1  (Cont.)  Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 

>RUN  DUMOO 


* ♦ ♦ AT ♦  --  DELAYING 


♦♦♦AT*  --  Continuing 
>RUN  RTROO 

> 

>INS  NUL2/TASK=QT0000 
>1  NS  NUL2/TASK  =  QT0100 
>INS  NUL2/TASK=QT0200 
>INS  NUL2/TASK=QT0300 

>*  »»»  THE  LOAD  TEST  IS  RUNNING  ««« 

>REM  QTOOOO 

>REM  QT0100 

>REM  QT0200 

>REh  QT0300 

>REH  DUMOO 

>REM  LOGOO 

>REM  QTROO 

>  t 

i  *  LOAD  TEST  COMPLETED  AT  14:34*17  * 


t 

>  *  IOX  TEST  STARTED  AT  14*34:17  * 

f 

f  ****  NOTE  **** 

* 

5  TEST  MEDIA  MUST  BE  LOADED  ON  ALL  TAPE  AND  DISK  DRIVES ♦ 
?  AND  FILES-11  FORMAT  DISKS* 


USE  SCRATCH  TAPES 


;  ALL  MAGTAPES  BEING  TESTED  ARE  OVER-WRITTEN*  THE  DISKS  ARE 
i  TESTED  WITH  FILE-STRUCTURED  I/O  WITH  NO  NEGATIVE  EFFECT  ON  DATA 
5  OR  STRUCTURE* 

F 

J  BEFORE  PERFORMING  THE  FILE-STRUCTURED  I/O  TEST,  ALL  UNMOUNTED 
i  DISKS  ARE  MOUNTED  AUTOMATICALLY. 

» 

»  DEVICES  LISTED  AS  'OFFLINE1  ARE  NOT  PHYSICALLY  PRESENT  AND  ARE  NOT 
f  TESTED.  INDIVIDUAL  MAG  TAPE,  DEC  TAPE  AND  RK05  UNITS  CAN 
»  ERRRONEOUSLY  BE  SHOWN  AS  ONLINE  WHEN  THE  CONTROLLER  IS  ONLINE. 

>*  THEY  are  tested  and  the  test  fails  after  several  minutes 

>t  OF  ERROR  MESSAGES. 

V  £ 


>F  IF  ANY  DRIVERS  ARE  UNLOADEDf  THEY  WILL  BE  LOADED  NOW* 

>  F 

>  F  ********** 

>  F  ********************************************************** 

>INS  $  I OX/T  ASK  =  * ♦ *SIO 


7 

>f  THE  SYSTEM  I/O  EXERCISER  WILL  RUN  FOR  3  MINUTES 

>SIO  0IOXCN 

SI 0  Summary  of  exerciser  activity  at  20-JUL-81  14*34*10 
TIME  --  Runt  3  min*  Elapsed:  3  min*  Remaining:  0  min* 

DKO:  3f357*  R/W  requests  totaling  3»357*  blocks  with  no  errors 

DLO:  --  2f881*  R/W  reeuests  totaling  2f881*  blocks  with  no  errors 

DLl :  --  2  f  930 ♦  R/W  requests  totaling  2*930*  blocks  with  no  errors 

DMO :  5*901*  R/W  requests  totaling  5*901*  blocks  with  no  errors 

MMO:  651*  R/W  requests  totaling  651*  records  with  no  errors 

AST's  executed:  15f720* 

Idle-loop  iterations:  6f798* 


(continued  on  next  page) 


9-10 


USER  ENVIRONMENT  TEST  PACKAGE  (UETP) 


Example  9-1  (Cont.)  Sample  UETP  Console  Dialog  for  a  System  Using  RLOls 

ACCUMULATED  TOTALS: 


TIME  --  Run#  3  min*  Elapsed:  3  min*  Remaining*  0  min* 

DKO:  --  3*351*  R/W  requests  totaling  3*358*  blocks  with  no  errors 

DLOt  —  2*882*  R/W  requests  totaling  2*882*  blocks  with  no  errors 

DL1*  --  2*931*  R/W  reauests  totaling  2*931*  blocks  with  no  errors 

DM0*  —  5*902*  R/W  reauests  totaling  5*902*  blocks  with  no  errors 

MMO*  --  652*  R/W  requests  totaling  652*  records  with  no  errors 
AST's  executed:  15*725* 

Idle-loop  iterations:  6*798* 


>REM  SIO 
>  * 

>*  *  IOX  TEST  COMPLETED  AT  144*344*54  * 

>*  *  UTILITIES  TEST  STARTED  AT  14!34:54  * 

>*  *  CMP  VERIFICATION  * 

>* 

>TIM 

14:34:55  20-JUL-81 
>PIP  COMPAR*CMD=SIOE*CMD 

> !  INVOKE  CMP  TO  COMPARE  IDENTICAL  FILES 
>CMP  TI  :=COMPAR*CMD*SIOE*CMD 

1)  DLi:C2*300DC0MPAR*CMD* 1 

2)  DLi:C2*300DSI0E*CMD*l 


No  differences  found 
TI { =C0MPAR ♦ CMD * SIOE  *CMD 

> !  NO  DIFFERENCES  SHOULD  HAVE  BEEN  FOUND 

>  ! 

> !  INVOKE  CMP  TO  COMPARE  DIFFERING  FILES 
> CMP  Ti:=FILEl*  *FILE2* 

******************  ******************************** 

1)  DLi:C2*3001FILEl* *1 

6  **  IF  CMP  IS  FUNCTIONING*  THIS  LINE  FROM  FILE1*  IS  DIFFERENT* 

7  *  *  THE  REST  OF  THE  LINES  ARE  IDENTICAL* 

*************** 

2)  DLi:C2*3001FILE2*  *1 

6  **  THIS  LINE  IS  THE  FILE2 ♦  LINE  WHICH  DIFFERS  FROM  THE  ABOVE* 

7  **  THE  REST  OF  THE  LINES  ARE  IDENTICAL* 

1  differences  found 
Ti:=FILEl • *FILE2* 

> !  ONE  DIFFERENCE  SHOULD  HAVE  BEEN  FOUND 
>PIP  COMPAR*CMD**/DE 
>* 

>TIM 

14:34:59  20-JUL-81 

>; 

>i  *  CMP  VERIFICATION  COMPLETE  * 

>i 

>i  *  FLX  VERIFICATION  * 

>INS  LB:C1*543FLX/TASK=* * *FLX 

DMO  —  TTO :  Dismounted  from  DKO:  ***  Final  dismount  initiated  *** 

14:35:14  ***  DKO »  —  Dismount  complete 

>FLX  DKO : /ZE/DO 

>FLX  DK0:/D0=NUL1*MAC/RS*NUL2*MAC*NUL3*MAC 
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Example  9-1  (Cont.)  Sample  UETP  Console 
>FLX  DK0  5 /DO/LI 


Di rectory 
20-JUL-81 

D  K  »  C  2 » 

3001 

NUL 1 ♦ MAC 

1 9  ♦ 

20- JUL-81 

<233> 

NUL2 ♦ MAC 

1 9 » 

20-JUL-81 

<233  > 

NUL3 ♦ MAC 

1 9  ♦ 

20- JUL-81 

<233  > 

Total  of  57  * 

blocks 

in  3*  files 

>FLX  DK05/ZE/RT 

>FLX  DK0J/RT=NUL1 . MAC > NUL2 . MAC > NUL3 . MAC 
> F L X  DK05/RT/LI 


DIRECTORY  DK05 

20-JUL-81 


NUL1 

♦  MAC 

19. 

20- JUL-81 

NUL2 

♦  MAC 

19. 

20-JUL-31 

NUL3 

« MAC 

19. 

20- JUL-81 

<  Unused  > 

4721  ♦ 

Dialog  for  a  System  Using  RLOls 


4721,  Free  blocks 

Total  of  57,  blocks  in  3,  files 


>REM  FLX 

>»  *  FLX  VERIFICATION  COMPLETE 

>  i 

>i  *  DMP  VERIFICATION  * 

>i 


* 


>TIME 

14*35*09  20- JUL-81 

>INS  LB:C1»54DDMP/TASK=, , , DMP 

>DMP  TI*,=ASRC.XXX/AS/RC 

Dump  of  DLi:C2>3001ASRC.XXXf 1  -  File  ID  55rl»0 

Record  number  01.  -  Size  16.  bytes 


000000  D  M  P 


WORKS  ! 


***  EOF  *** 


>REMQVE  ...DMP 
>TIME 

14:35511  20- JUL-81 
>i 

>»  *  DMP  VERIFICATION  COMPLETE  * 

>) 

>*  *  CREF »  PMD  AND  PRT  VERIFICATION  * 

>i 

>i  THIS  ROUTINE  OPERATES  THE  FOLLOWING  UTILITIES: 

>i  MACfTKB,CREF,PMD>PRT 

>  9 
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>*  IF  ALL  ARE  FUNCTIONAL!  AN  EXAMPLE  OF  A  MACRO  LISTING  WITH  SYMBOL 

> 9  AND  MACRO  CROSS-REFERENCE  LISTINGS  ATTACHED  IS  SPOOLED  TO 

>i  THE  LINE  PRINTER  *  A  TASK  WILL  BE  RUN  AND  IT  WILL  CRASH  AND  A 

>;  POST-MORTEM  DUMP  LISTING  OF  THE  CRASHED  TASK  IS  SPOOLED ♦ 

>  i 

>  T I M 

14*35*12  20- JUL-81 

>INS  LB:Cl!543CRF/TASK=* ♦ *CRF 

UFD  SY:ilf43 

>  f 

>MAC  CRTEST»CR TEST /CR=CR TEST 
>TKB  CR TES T /PM = CRTEST 
>INS  CRTEST 

>  9 

>  f 

>RUN  CRTEST 

>f 

14*35*20  Task  "CRTEST"  terminated 

Odd  address  or  other  trap  four 

R0=000000 

R 1=111111 

F?  2  =  022222 

R3 =033333 

F<!  4  =  044444 

R5=055555 

SP=001 1 72 

PC-OO 1236 

PS= 1 70001 

Postmortem  Dump  will  be  generated 

>REM  CRF 
>TIM 

14**35:20  20- JUL-81 

>  f 

>t  *  CREF  f  PMD  AND  PRT  VERIFICATION  COMPLETE  * 

>i 

s.  * 

>5  *  DSC  VERIFICATION  * 

>  f 

>TIM 

14:35:21  20- JUL-81 
>INS  LB:Clf541DSC 
>SET  /UIC  =  C2  9 300D 

>9 

>»  BECAUSE  YOU  DO  NOT  HAVE  A  FLOPPY  DRIVE  OR  DEC  TAPE  9 
>;  AN  AUTOMATIC  VERIFICATION  OF  DSC  OPERATION  IS  DEEMED 

>  t  IMPRACTICAL* 

>f  THE  DSC  TEST  IS  BEING  SKIPPED* 


>  9 

>REM  DSC 

>PIP  t ♦ TMP f #/DE 

PIP  --  No  such  file(s) 

SY0:C2f3003»*TMPf* 

>* 

> 9  *  LBR  VERIFICATION  * 

>i 

>TIME 

14**53:52  20-JUL-81 

>!  Create  an  object  module  library* 

>lbr  objlib/cr: : : :obj 

>!  Insert  three  object  modules  into  the  library* 
>LBR  0BJLIB/IN  =  GBJCT1 9  OB JCT2 9  OB JCT3 
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> !  Insert  an  existing  module  into  the  library  (error  expected). 

>LBR  0BJLIB/IN=0BJCT2 

LBR  --  #FATAL#~ Duplicate  module  name  *0BJ2  •  IN  0BJCT2.0BJ52 

>!  Replace  two  existing  modules. 

>LBR  0BJLIB/RP=0BJCT1 >  OB JCT2 
Module  '  OB  Jl  *  replaced 

Module  *0BJ2  *  replaced 

> !  Display  the  contents  of  the  object  module  library. 

>LBR  OB JLI B/LE/FU 

Directory  of  file  0BJLIB.0LB51 
Object  module  library  created  by?  LBR  006.00 
Last  insert  occurred  20-JUL-81  AT  14554502 
MNT  entries  allocated?  2565  AVAILABLE?  253 
EPT  entries  allocated?  5125  AVAILABLE?  506 
File  space  available?  21897  WORDS 
Recoverable  deleted  space?  00150  WORDS 

##  Module?0BJl  Size?00075  Inserted  ?  20- JUL-8 1  Iderit?ID  1 


ENT  $A1  ENT  $B1 


**  Module?0BJ2  Size?00075  Inserted ? 20- JUL-8 1  Ident?ID  2 


ENT  $A2  ENT$B2 


**  Module?0BJ3  Size?00075  Iriserted?20-JUL-81  IdentllD  3 


ENT$A3  ENT$B3 


>PIP  OB JL IB .  #  5  3(t / DE 
>TIME 

14154505  20- JUL-81 

>*  *  LBR  VERIFICATION  COMPLETE  * 

>5 

>5  *  PAT  VERIFICATION  * 

y  5 

>TIME 

14554506  20- JUL-81 

>INSTALL  LB?  11*543 PAT/TASK=. ,  .F'AT 

>!  Create  an  updated  object  file. 

>PATCH  PATCH D.PAT=0BJCT1»F'ATCH1 

> !  Compare  the  updated  object  file  with  one  of  known  Quality. 
>CMP  TI ?=PATCHD.PAT»PATCHD.XXX 

1)  DL1?C2»3003PATCHD.PAT51 

2)  DL1?C2»3003PATCHD.XXX51 

No  differences  found 
TI?=PATCHD.PAT»PATCHD.XXX 
PIP  #.PAT5#/DE 
REMOVE  ...PAT 
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>T  IME 

14:54U0  20- JUL-81 

>  *  *  PAT  VERIFICATION  COMPLETE  * 

>  * 

>9  *  SLP  VERIFICATION  * 

>9 

>TIME 

14:54U0  20- JUL-81 

>9  Invoke  the  SLP  Editor  to  edit  3  data  file* 

> SLP  0SLPCMD 

>9  Verify  that  the  editing  was  properly  performed# 

>CMP  TI :=0UTPUT  ♦  S  L  P  *  S  L  P  0  U  T  #XXX 

1 )  DLi:C2*30030UTPUT*SLP*l 

2)  DL1!C2*3003SLPOUT  XXX*1 


No  differences  found 
T I : ^OUTPUT ♦ SLP  ?  SLPOUT ♦ XXX 
>PIP  *#SLPf*/DE 
>T  IME 

14:54:14  20-JUL-81 

>9  *  SLP  VERIFICATION  COMPLETE  * 

>9  *  UTILITIES  TEST  COMPLETED  AT  14:  544*  14  * 

>*  *  MCR  COMMANDS  TEST  STARTED  AT  14:54:14  * 

>9  *  ALL  f  BAD  9  INI  *  MOU*  UFD*  VFY»  DM0  AND  DEA  VERIFICATION  * 

>  9 

>9  THIS  ROUTINE  CHECKS  THE  DISK-ACCESSING  MCR  COMMANDS  ALL*  INI*  BAD* 
>*  MOU*  UFD*  VFY *  DMO  AND  DEA. 

>*  ALL  AND  DEA  ARE  TESTED  ONLY  FOR  A  MULTI-USER  SYSTEM* 

>*  THIS  ROUTINE  REQUIRES  EITHER  ONE  SCRATCH  DISK  DRIVE  OR  DECTAPE 
>*  OR  ANSI  SUPPORT  FOR  MAGTAPE*  IT  WILL  NOT  USE  A  PUBLIC  DISK* 

>*  IF  ONLY  MAGTAPE  IS  AVAILABLE*  A  SUB-SET  OF  THE  TEST  IS  RUN* 

>  * 

>1  NS  LB : $BAD/TASK= ♦ * .BAD 

>INS  LBUVFY/TASK=*  ♦  *VFY/INC=10000 

>dev  dk: 

DKO :  TTO :  -  PRIVATE  LOADED 
> ACS  DKO : /BLKS=0 ♦ 

ACS  --  File  not  in  use 

>dmq:  dko : /dev 

DMO  —  Volume  not  mounted  DKO: 

>DEA  DKO : 

>ALL  dko: 

> bad  dko: 

BAD  --  DKO4*  Total  bad  blocks^  1* 

> I N I  DK0:SCRTCH/BAD=CAUT03/EXT=4/FPR0=CR*RW*RWE*RWED3/INDX=BEG/VI 
**  VOLUME  INFORMATION  FOR  DKO :  ** 


Label 

/BAD 

/CHA 

/EXT 

/FPRO 

/ 1 N  D  X 

/INF 

/LRU 

/MXF 

/PRO 

/UIC 

/WIN 


SCRTCH 
CAUT03 
C  3 
4* 

CR*RW*RWE*RWED3 

BEG 

147* 

3* 

294* 

C RWED *  RWED *  RWED *  RWED3 
Cl*  13 
7* 


THEORETICAL  MAXIMUM  FILES 


2357* 


(continued 
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>INI  DKO : SCRTCH/ 1 NDX  =  BE6/INF  =  20/LRU  =  3/MXF  =  100/PR0=CRfRWf  RUE  > R WED 3/ VI 


**  VOLUME  INFORMATION  FOR  DKO  t  ** 


LABEL 

/BAD 

/CHA 

/EXT 

/FF'RO 

/ 1 NDX 

/INF 

/LRU 

/MXF 

/PRO 

/UIC 

/WIN 


SCRTCH 

CAUT03 

C3 

5  4 

C RWED  f  RWED  f  RWED  f  R3 
BEG 
1 6  ♦ 

3* 

64* 

CRf RWfRWEfRWEDI 
CIf  13 
7  ♦ 


THEORETICAL  MAXIMUM  FILES  =  2357* 


> I N I  DKO:SCRTCH/UIC=C2f 3003/UIN=7/VI/INF=20 


**  VOLUME  INFORMATION  FOR  DKO l  ** 


LABEL 

/BAD 

/CHA 

/EXT 

/FPRO 

/ 1  NDX 

/INF 

/LRU 

/MXF 

/PRO 

/UIC 

/WIN 


SCRTCH 

CAUT03 

LI 

5* 

CRWED  »  RWED f  RWEDf R3 
MID 
16* 

3* 

294* 


CRWED f RWEDf RWEDf RUED  3 
L2f 3001 
7. 


THEORETICAL  MAXIMUM  FILES  =  2357* 


>M0U  DKOJSCRTCH/VI/OVR 
Volume  Information 
Class:  Files-11 

Device:  DKOO 

Volume  label : SCRTCH 


Owner ♦ 
Protection: 
Default: 
Processor : 


C2f3003 

CRWCD  ? RWCD  f RWCD r RWCD3 
CRWED  t  RWED  f RWED  t R3 
F11ACP 


>DEV  dk: 

DKO ♦  TTO :  -  PRIVATE  MOUNTED  LOADED 
>PIP  DK0:C0f03/FU 
Directory  DK04*C0f03 
20- JUL-81  14J56 
INDEXF.SYSfI  (1,1) 

Cl f13  CRWED f RWEDf RWED fR3 

BITMAP «  SYS  f 1  ( 2  f  2 ) 

CIf 13  CRWED f RWEDf RWED fR3 

BADBLK ♦ SYS  *  1  (3f3) 

C 1 f 1 3  RWEDfRWEDfRWEDfR3 

OOOOOO/DIRfI  ( 4  f  4 ) 

Cl f 13  CRWED f RWEDf RWED fR3 


L ABEL=SCRTCH 


24. /24* 

20-JUL-81 

14:56 

3*/3* 

20- JUL-81 

14:56 

2f/2. 

20 -JUL-81 

144*56 

1*1/1* 

20-JUL-81 

1 4 : 5 

(continued  on  next  page) 
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CORING ♦ SYS f 1  <  5  f  5 )  0*/0.  20-JUL-81  14:56 

C  1  f  1  3  C  RWED  f  RWED f  RWED f  R 3 

Total  of  30»/30*  blocks  in  5*  files 
>PIP  DKOt/FR 

DKO:  has  4770 ♦  blocks  freeF  30*  blocks  used  out  of  4800* 

Largest  contiguous  space  =  2383*  blocks 

289*  file  headers  are  freeF  5*  headers  used  out  of  294* 

>VFY  DKOt/LO 


Ot  Lost  files  were  found 


>VFY  DKOt/LI 

Listing  of  index  on  DKO l 

File  ID  000001f000001  INDEXF 
File  ID  000002  f  000002  BITMAP 
File  ID  000003 f 000003  BADBLK 
File  ID  000004 f 000004  000000 
File  ID  000005  f  000005  CORIMG 
>VFY  DKO ♦ /FR 

DKO:  has  4770*  blocks  freeF 
>VFY  DKOt/RC 

Read  check  of  files  on  DKO : 


♦  SYS  f 1 

Owner 

C  1  f  1 3 

♦  SYS  f 1 

Owner 

C  1  f  1  3 

* SYS?1 

Owne  r 

C  1  f  1  3 

♦  D I R  f  1 

Owner 

Cl  f  13 

♦  SYS  f 1 

Owner 

C  1  f  1  3 

30f  blocks  used  out  of  4800* 
-  Blocking  factor  13* 


> U F D  DK0:C2f3003/ALL0C=344/PR0=CRfRWfREWfREWD3 

>PIP  DKO  ♦  C  2  f  300  3  =  DK0  ♦  C  0  f  0  3BADBL.K  ♦  SYS 

>PIP  DK0:C2f3003/FU 

Directory  DKO : C2f  300  3 

20-JUL-81  14J56 

BADBLK*SYSf1  <  7  f 1 )  2 ♦ /2  *  20-JUL-81  14*56 

C 2  f  300  3  CRWEDf RWED f RWED fR3 
Total  of  2  ♦  /2  ♦  blocks  in  !♦  file 
> D M 0  DKO : 

DM0  --  TTO:  dismounted  from  DKO:  ♦♦♦Final  dismount  i  ni  t  iated^M 

14:56:32  ♦♦♦DKO:  --  Dismount  complete 


>DEA  DKO : 


>DEV  dk: 

DKO :  LOADED 
>REM  VFY 
>REM  BAD 

>9  ♦  ALL  f  BADf  INIf  MOUf  UFDf  VFYf  DM0  AND  DEA  ♦ 

>f  ♦  VERIFICATION  COMPLETE  ♦ 

>9  ♦  MCR  COMMANDS  TEST  COMPLETED  AT  14:58:58  ♦ 

>9 

>9  ♦  INTERACTIVE  UTILITIES  TEST  STARTED  AT  14:58:59  ♦ 

>  F 

>9  ♦  INTERACTIVE  UTILITIES  VERIFICATION  ♦ 

>$ 


>t 

>9 

>T  I M 


DEPRESS  CARRIAGE  RETURN  TO  CONTINUE  FROM  EACH  EDITO 
SUCCESSFULLY  INVOKED  AND  CTRL  2  TO  EXIT  FROM  ACNT ♦ 


R 


14:58:59  20- JUL-81 


>ED I  QQQQ.XXX 
CCreating  new  file3 
Input 

TESTING  TEST  ING 
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>ABO  EDI 

14559:20  Task  ■♦♦♦EDI"  terminated 

Aborted  via  directive  or  CLI 
And  with  pending  I/O  requests 


>  f 

>PIP  GGGG ♦ XXX f */DE 
>INS  LB:tlf541EDT 
>EDT 
EDT> 

>ABO  EDT 

14559532  Task  ■♦♦♦EDT'  terminated 

Aborted  via  directive  or  CLI 
And  with  pending  I/O  requests 


s'  F 

>REM  EDT 

> INS  LB:C1f541ZAP 

>ZAP 

ZAP> 

>ABO  ZAP 

14559542  Task  ■♦♦♦ZAPi  terminated 

Aborted  via  directive  or  CLI 
And  with  pending  I/O  requests 

>f 

>REM  ZAP 

>INS  lb:c:i»54Dacnt/task  =  acnt 
> RUN  ACNT 

*  ACCOUNT  FILE  MAINTENANCE  PROGRAM  « 

Options  are:  A  -  ADD,  C  -  CREATE  FILE,  D  -  DELETE  f  E  -  EXAMINE* 

L  -  LISTf  M  -  MODIFY  f  S  -  SORTf  CTRL/Z  -  EXIT 
Enter  option:  ~Z 
OPERATION  COMPLETE 

> 

>REM  ACNT 

>  T I M 

15:00:i4  20- JUL-81 

>  F 

>f  *  INTERACTIVE  UTILITIES  TEST  COMPLETED  AT  15:00:i5  * 

>f 

>f  IF  ANY  ERRORS  HAVE  BEEN  LOGGED  BY  THE  ERROR  LOGGERf  YOU  SHOULD  INVESTIGATE 
>f  FURTHER  BY  RUNNING  THE  ERROR  LOGGER  REPORT  GENERATOR  <RPT> 

> f  AFTER  THE  UETP  COMMAND  FILE  EXITS ♦ 

>ELI  /SHOW 

Error  Logging  Status  20-JUL-81  15500527 

Logging:  On  Limiting:  On 

Log  File:  SY0:C1f63L0G*ERR  File  ID:  DLO :  320f111 
Backup  File:  SYO J C 1 f 61BACKUP ♦ ERR 
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Device 

Hard  Error 

Soft  Error 

QIO 

Name 

Count/Limit 

Count/Limit 

Count 

dbo: 

0  ♦  /5  * 

0  ♦  /8  * 

0* 

dko: 

0  ♦  /5  ♦ 

0  ♦  /8  * 

0* 

dlo: 

0  ♦  /5  ♦ 

0  ♦  /8  ♦ 

12292* 

dl  1 : 

0  ♦  /5  ♦ 

0  ♦  /8  ♦ 

6229* 

DMO : 

0  ♦  /5  ♦ 

0  ♦  /8  • 

5970* 

dmi  : 

0  ♦  /5  ♦ 

0  ♦  /8  ♦ 

0* 

dyo: 

0  ♦  /5  ♦ 

0  ♦  /8 « 

0* 

(Offline) 

dyi: 

0*/5* 

0  ♦  /8  ♦ 

0* 

(Offline) 

mmo: 

0  •  /5  ♦ 

0 

\ 

00 

19* 

>ELI  /- 

LOG 

ERRLOG 

—  Error  Lossins 

stopped 

>REM  ELI 

>t  RESTORE  SYSTEM  TO  PRE-UETP  STATE 

>REM  MAC 

>REM  TKB 

>REM  CMP 

>REM  LBR 

> R E M  EDI 


>*  ***********************************************************%******* 
>r  *  * 

> f  *  RSX-UM  U4,0  UETP  PROCEDURE  COMPLETED  AT  15501 505  ON  20-JUL-81  * 

>r*  # 

>PIP  * ♦ */PU « 4 
>REM  DEFINE 
>ABO  T2RMD 

1550i:il  Task  B  T  2  R  M  D  ■  terminated 


Aborted  via  directive  or  CLI 


>REM  T2RMD 

✓REMOVE  CRTEST 

>PIP  TAILOR *  DAT  f  */DE/NM 

>PIP  DULSE T  ♦  CMD  f  #  y  DVLREM ♦ CMD  f  *  f  REMUTL ♦ CMD  f  * , CONF IG ♦ CMD  f  */DE/NM 

>PIP  UETPASM*CMDf * fUETPBLD *CMD y * f RUNLOG.DATf * ,ERRLQG *  DAT f * ,1 OXCNF* D AT f */DE/NM 

>PIP  CRTEST*0BJf#fQBJCT1*GBJf#f0BJCT2*GBJf*f0BJCT3*QBJf#fDUMMY*TSKf#/DE/NM 

>PIP  L0GGER*TSK$*fQTRUN*TSKf*fNUL1 *TSKy*yNUL2*TSKF*yNUL3*TSKy*/DE/NM 

>PIP  CRTEST  *LSTi*FUEFINE*TSK**F  CRTEST  *TSKf*/DE/NM 

>SET  /UIC-C2  f3003 

>0  <EOF> 

> 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


Method  4: 

>  RUN  $VMR 

The  system  installs  VMR  from  the  pseudo  device  LB:  under  the 

system  UFD  (normally,  [1,50]  for  unmapped  systems  and  [1,54]  for 
mapped  systems)  and  loads  it.  VMR  then  responds  with  the 
following  prompt: 

ENTER  FILENAME: 

In  all  starting  methods  except  Method  1,  VMR  prompts 
ENTER  FILENAME: 

At  this  point,  you  specify  the  file  that  contains  the  image  of  the 
RSX-11M  or  RSX-1 1M-PLUS  system  you  want  to  modify. 

VMR  expects  to  find  a  symbol  definition  file  of  the  same  name  as  that 
of  the  system  image  file,  but  with  a  file  type  of  .STB,  on  the  same 
device  and  under  the  same  UFD  as  those  of  the  system  image  file 
(except  when  you  use  the  /IM  switch;  see  Section  10.2).  For  example, 
suppose  you  enter  the  following  file  specification  in  response  to  the 
prompt : 

RSX11M.SYS 

A  corresponding  file,  RSX11M.STB,  must  exist  that  contains  the  symbol 
definitions  for  the  RSX11M.SYS  system  image. 


NOTE 

If  the  system  image  file  you  wish  to 
modify  is  not  on  the  device  assigned  as 
SY:  and  LB:,  you  must  assign  both  SY: 

and  LB:  to  the  system  image  file's 

physical  device. 


The  system  image  and  symbol  definition  files  are  in  the  standard 
format  produced  by  the  RSX-1 1M/M-PLUS  Task  Builder. 

Upon  receiving  a  valid  file  specification,  VMR  opens  and  reads  the 
symbol  definition  file.  It  also  opens  the  system  image  file  and 
verifies  that  the  file  is  actually  a  system  image. 


On  RSX-11M-PLUS ,  if  the  system  image  file  you  specify  does  not  have 
Executive  data  space  support,  VMR  prompts  with: 


VMR> 

If  the  system  image 

fil 

e  you  specify  does  have  Executive  data  space 

support,  VMR  loads  t 

:he 

data  space  and  prints  the  following  message: 

Loading  Executi 

.ve 

data  space 

Data  space  load 

l  ing 

[  completed 

VMR  then  prompts  with: 


VMR> 
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You  can  now  enter  any  valid  VMR  command  or  terminate  VMR  by  typing 
CTRL/Z. 

If  you  used  Method  1  to  start  VMR,  the  first  line  in  the  specified 
indirect  command  file  must  contain  a  file  specification  for  the  system 
image  file  that  is  to  be  modified. 

In  addition  to  specifying  an  indirect  command  file  to  start  VMR,  you 
can  also  enter  the  following  any  time  that  VMR  prompts  for  input: 

@  f ilespec ification 

This  directs  VMR  to  extract  command  input  from  the  specified  file 
until  it  reaches  an  end-of-file  and  then  to  return  to  the  terminal  for 
further  input.  This  feature  of  VMR  is  useful  when  you  want  to  repeat 
a  series  of  commands  for  several  generated  systems  (INSTALL  commands, 
for  example)  . 

VMR  allows  two  levels  of  indirect  command  files.  This  means  you  can 
invoke  a  second  command  file  from  within  the  first  file.  Trying  to 
invoke  another  file  from  within  the  second  file  results  in  an  error 
message . 


10.2  VMR  FILE  SPECIFICATIONS 

VMR  accepts  the  standard  RSX-11M/M-PLUS  file  specification  format: 
ddnn : [g ,ml filename .type ; ver [/IM] 

ddnn : 

The  device  unit  on  which  the  volume  containing  the  desired  file 
resides  (for  example,  DM0:  or  DTI:).  The  name  consists  of  two 
ASCII  characters,  followed  by  an  optional  1-  or  2-digit  octal 
unit  number.  The  default  device  is  SYO:. 


[g  fin] 

The  UFD  in  which  the  file  is  listed.  The  variables  g  and  m  are 
octal  numbers  from  1  to  377  that  represent  the  file  owner's  group 
and  member  number,  respectively.  The  brackets  are  a  mandatory 
part  of  the  UFD  syntax.  The  default  is  the  UIC  under  which  VMR 
is  running . 

filename 

The  name  of  the  file.  An  RSX-1 1M/M-PLUS  file  name  can  consist  of 
up  to  nine  alphanumeric  characters.  The  file  name  and  file  type 
are  always  separated  by  a  period  (.).  You  must  specify  the  file 
name.  No  default  is  applied. 


type 


The  file  type,  consisting  of  up  to  three  alphanumeric  characters. 
The  file  type  and  version  number  are  always  separated  by  a 
semicolon  (;)•  The  defaults  are  .SYS  for  system  image  files, 
.TSK  for  task  image  files,  and  . CMD  for  indirect  command  files. 
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ver 

The  version  number  in  the  range  of  0  through  77777(8).  The 
default  is  the  highest  version  in  the  UFD. 

/IM 

A  switch  that,  when  applied  to  the  system  image  file 

specification,  overrides  the  VMR  requirement  for  the  symbol 
definition  file.  When  you  use  the  /IM  switch  with  the  file 
specification,  the  only  command  VMR  will  accept  is  the  SAVE 
command . 

This  is  the  only  switch  provided  with  VMR.  You  use  it  to  write 
non-RSX-1 1M/M-PLUS  system  images  to  secondary  media  in 

bootstrappable  format.  The  switch  is  also  useful  when  you  use  an 

RSX-1 1M/M-PLUS  system  as  a  host  system  for  developing  small, 

memory-resident  systems  that  must  be  loaded  from  a  serial  medium 
(such  as  paper  tape) . 


10.3  COMMAND  SYNTAX 

You  do  not  have  to  give  an  entire  command  name  to  VMR.  VMR  accepts 
three  characters  and  then  searches  for  a  space  or  tab  followed  by  the 
command  parameters  or  by  a  RETURN  if  there  are  no  parameters.  Because 
VMR  requires  a  space  or  a  tab  preceding  parameters,  VMR  does  not  allow 
embedded  spaces  in  a  command  name.  If  you  enter  a  command 
incorrectly,  VMR  displays  an  error  message  at  your  terminal. 

The  following  example  illustrates  the  format  of  the  TIME  command. 
Note  that  the  square  brackets  in  the  example  indicate  that  the  "E"  is 
optional : 

VMR>TIM  [E  ]  (RET) 


10.3.1  Keywords 

Some  commands  use  keywords  that  apply  to  the  command  argument.  A 
keyword  consists  of  a  slash  (/)  ,  followed  by  an  alphanumeric 
identification,  and,  optionally,  followed  by  an  equal  sign  (=)  and  the 
value  of  the  keyword,  as  follows: 

/keywo  rd=val ue 

You  can  enter  keywords  in  any  order.  For  example,  the  INSTALL  command 
requires  a  file  name  parameter  specifying  the  task  to  be  installed. 
You  can  append  keywords  to  the  file  name.  One  such  keyword,  /TASK, 
specifies  the  name  under  which  the  task  is  to  be  installed. 

VMR>INS  TEST. TSK/TASK=SUPER 

This  command  line  causes  the  task  contained  in  the  file  named  TEST. TSK 
to  be  installed  with  the  name  SUPER.  Keywords  are  command-specific 
and  are  defined  with  each  command  (Section  10.5). 
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10.3.2  Comments 

VMR  treats  a  line  of  text  as  a  comment  if  the  first  character  in  the 
line  is  a  semicolon  (;).  In  addition,  you  can  use  the  exclamation 
mark  (!)  to  delimit  comments  within  a  command  line.  The  first 
exclamation  mark  starts  the  comment  and  the  next  exclamation  mark  or 
RETURN  terminates  the  comment.  VMR  ignores  all  text  between  the  two 
exclamation  marks.  For  example: 

VMR>;  THIS  LINE  IS  A  COMMENT 

VMR>TAS  ! THIS  IS  A  COMMENT  STRING! 

Comments  are  especially  useful  to  clarify  commands  in  VMR  indirect 
command  files.  (Refer  to  the  RSX-11M/M-PLUS  MCR  Operations  Manual  for 
more  information  on  indirect  command  files.) 


10.4  COMMAND  SUMMARY 

The  VMR  commands  described  in  this  chapter  are  listed  below  by 
category.  The  detailed  descriptions  of  the  VMR  commands  are  given  in 
Section  10.5  in  alphabetical  order. 


Initialization  Commands 

ASSIGN  Define,  delete,  or  display  a  global  logical  device 

assignment.  List  current  assignments  on  console 


terminal . 

CONFIGURATION 

(RSX-1 1M-PLUS  systems  only.)  Display 

configuration,  or  change  a  device’s  CSR 
address . 

system 
or  vector 

INSTALL 

Install  a  task  into  the  system  image. 

LOAD 

Load  a  device  driver. 

REDIRECT 

Redirect  I/O  requests  from  one  physical  < 
another . 

ievice  to 

SAVE 

Write  the  system  image  file  onto  a  secondary 
bootstrappable  format . 

medium  in 

SET 

Set  a  variety  of  system  and  terminal  charac 
This  command  has  both  device  characteristic 
and  memory  allocation  keywords. 

ter istics. 
s  keywords 

TIME 

Enter  time  and/or  date  into  the  system  image 
the  time  and  date. 

;  display 

UNLOAD 

Unload  a  device  driver. 

Informational 

Commands 

DEVICES 

Display  a  list  of  the  peripheral  devices  d 
the  system  image. 

efined  in 

LUNS 

Display  the  list  of  LUN  assignments  for  an 
task . 

ind icated 
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PARTITIONS 

Display  the  list  of  partitions  defined 
image . 

in 

the 

system 

TASKLIST 

Display  a  list  of  the  tasks  installed 

in 

the 

system 

On  RSX- 
pr  imary 
pool . 

11M-PLUS 

pool 

,  the 
and 

display  li 
then  tasks 

LStS 

5  in 

tasks 

stalled 

installed  in 

1  in  secondary 

Task  Control  Commands 


ALTER 

CANCEL 

FIX 

REASSIGN 

REMOVE 


Alter  the  priority  of  a  task. 

Cancel  the  time-based  initiation  requests  for  a  task. 
Fix  a  task  in  the  system  image. 

Change  a  task's  LUN  assignment. 

Remove  a  task  from  the  system  image. 


RUN 


UNFIX 


Schedule  a  task's  activation.  The  task  may  run  after 
one  clock  tick,  after  a  delay,  or  in  synchronization 
with  the  system  clock.  Periodic  rescheduling  is 
optional . 


Unfix  a  task  from  the  system  image. 


10.5  VMR  COMMAND  DESCRIPTIONS 

The  following  subheadings  are  used  in  the  detailed  command 
descriptions  in  this  section.  Subheadings  that  do  not  apply  to  a 
particular  command  are  omitted  from  the  command  description. 

Command  Acronym 

This  subheading  consists  of  the  minimal  form  of  the  command  name 
in  capital  letters.  The  acronym  is  at  the  outside  margin  of  each 
pag  e . 

Command  Name 

This  subheading  consists  of  the  full  command  name  in  capital 
letters.  The  text  following  the  name  describes  the  command's 
function . 

Format 

The  command  line  format  is  given  and  all  parameters  are  listed. 
Parameters 

Parameters  are  listed  and  described. 
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Keywords 

Keywords 

Examples 

Examples 


are  listed  and  described. 


of  the  command  output  are 


shown . 


Notes 


A  list  of  special  considerations  that  may  assist  you  in 
command  properly  appears  under  this  subheading. 


using 


the 
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ALT 

ALTER 

Use  the  ALTER  command  to  change  the  static  priority  of  an 
task. 

Format 

ALT [ER]  taskname  /PRI=pr ior ity 
Parameters 
taskname 

The  name  of  the  task  whose  priority  is  to  be  altered. 

/PRI 

The  keyword  that  changes  the  task's  static  priority, 
priority 

The  new  priority  to  be  assigned  to  the  specified  task, 
250  (decimal) . 

Example 

VMR>ALT  TEST  /PRI=248 • 

Alters  the  static  priority  of  task  TEST  to  248(10). 


installed 


from  1  to 
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ASN 


ASSIGN 

Use  the  ASSIGN  command  to  define,  delete,  or  display  logical-device 
assignments.  Logical-device  assignments  are  a  way  to  associate 
logical  names  with  physical,  pseudo,  or  logical  devices.  When  you 
assign  a  logical  name  to  a  pseudo  or  logical  device,  the  system 
resolves  the  assignment  to  the  associated  physical  device. 

There  are  three  types  of  logical-device  assignments:  global,  local, 

and  login.  VMR  supports  the  manipulation  of  global  assignments  only. 
Global  assignments  apply  to  all  tasks  in  the  running  system.  See  the 
RSX-1 1 M/M- PLUS  MCR  Operations  Manual  for  information  on  local  and 
login  assignments . 

A  logical  device  name  has  the  same  syntax  as  that  of  a  physical  device 
unit.  It  consists  of  a  2-character  ASCII  name  (alphabetic)  and  an 
optional  1-  or  2-digit  octal  unit  number,  followed  by  a  colon  (:). 
The  2-character  name  can  be  either  equivalent  to  a  standard 
RSX-1 1M/M-PLUS  device  name  (for  example,  DK:)  or  formed  by  two  letters 
picked  at  random  (for  example,  ZZ:). 

When  you  install  a  task  or  the  system  executes  an  ASSIGN  LUN 
directive,  the  system  scans  the  logical  device  table  before  it  scans 
the  physical  device  table  in  searching  for  a  specified  device.  As  a 
result,  you  can  define  logical  device  names  that  are  identical  to 
physical  device  names  even  though  the  logical  and  physical  device 
names  do  not  refer  to  the  same  physical  device.  The  system  resolves  a 
specified  device  name  to  the  first  matching  table  entry  found.  If  a 
logical  device  name  is  identical  to  a  physical  device  name,  the 
logical  name  has  precedence. 

Formats 

ASN  ppnn :=llnn:/GBL 

Define  a  global  assignment  that  associates  the  logical  name 
linn:  with  device  ppnn:. 

ASN  /GBL 

Display  all  global  assignments  for  the  system. 

ASN  = [linn : ] /GBL 

Delete  the  specified  global  logical  device  assignment  or,  if 
you  omit  linn:,  delete  all  global  assignments. 


Parameters 

PP 

A  physical,  logical,  or  pseudo  device  name, 
nn 

A  unit  number. 

11 

A  logical  device  name. 
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ASN  (Cont.) 


Examples 

VMR>ASN  DM : =GB0 :/GBL 

Defines  the  global  logical  device  name  GBO:  and  assigns  it  to 
DM: . 

VMR>ASN  /GBL 
GBO:  DM0:  Global 

Lists  all  global  assignments. 

VMR>ASN  =/GBL 

Deletes  all  global  assignments. 
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CAN 


CANCEL 

Use  the  CANCEL  command  to  cancel  time-based  initiation  requests  for  a 
task.  These  requests  result  from  the  RUN$  directive  or  any  of  the 
time-synchronized  variations  of  the  VMR  RUN  command. 

CANCEL  does  not  affect  the  execution  of  the  task  that  may  be  active  in 
the  saved  system  image.  It  removes  only  the  time-based  schedule 
requests  still  in  the  queue. 

Format 

CAN [CEL]  taskname 
Parameter 
taskname 

The  name  of  the  task  whose  time-based  initiation  requests  are  to 
be  canceled. 

Example 

VMR>CAN  XKE 

Cancels  all  periodic  rescheduling  and  time-based  initiation 
requests  for  task  XKE. 
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CON 

CONFIGURATION 

(RSX-1 1M-PLUS  systems  only.)  Use  the  CONFIGURATION  command  to  display 
system  configuration  information  on  your  terminal,  or  to  change  the 
CSR  or  vector  address  of  a  device. 

Format  1 

CON  DIS[PLAY]  [keyword] [FOR  string] 

Parameters 

keyword 

One  of  the  following  keywords: 

CONTROLLERS]  CPU 

UNI[TS]  FUL [L] 

FOR  string 

A  parameter  that  restricts  the  display  to  the  devices  matching 
the  specified  string. 

Keywords 

CON [TROLLERS] 

Displays  every  device  controller  that  is  in  the  current 
configuration . 

UNI [TS] 

Displays  every  device  unit  that  is  in  the  current  system. 

CPU 

Displays  the  CPUs  that  are  in  the  current  system. 

FUL [L] 

Displays  the  CPUs,  the  controllers,  and  the  device  units  in  the 
current  configuration.  If  you  do  not  specify  any  keyword,  CON 
DISPLAY  defaults  to  FULL.  The  controllers  display  contains 
(from  left  to  right)  the  following  information: 

•  The  controller  name 

•  Whether  it  is  on  line  or  off  line 

•  The  UNIBUS  Run  Mask  (URM) 

•  The  controller's  CSR  address 

•  The  controller's  starting  vector 

•  The  controller's  priority 
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CON  (Cont.) 


The  units  display  contains  (from  left  to  right)  the  following 
information  2 

•  The  logical  device  name 

•  The  physical  device  name  (including  physical  names  of 
both  ports  for  dual-ported  devices) 

•  Whether  the  device  is  on  line  or  off  line 

•  A  field  indicating  "driver"  is  loaded 

Examples 

Single-Processor  Systems 


VMR> CONFIGURATION  DISPLAY  CONTROLLERS 


RHA 

OFL 

CPA 

CSR=1 76700 

VEC=2 54  PRI 

=  5 

RHB 

OFL 

CPA 

CSR=1 76300 

VEC=1 50  PRI 

=  5 

RHC 

OFL 

CPA 

CSR=1 72040 

VEC=204  PRI 

=  5 

RHD 

# 

OFL 

CPA 

CSR=1 72440 

VEC=224  PRI 

=  5 

# 

• 

YMA 

OFL 

CPA 

CSR=1 70500 

VEC=300  PRI 

=  5 

YZA 

OFL 

CPA 

CSR=1 60100 

VEC=340  PRI 

=  5 

VMR> 

VMR>CON 

DIS  UNI 

DBO : 

RHA  0  2 

OFL  DRIVER 

DB1 : 

RHA1 2 

OFL  DRIVER 

DB2 : 

RHA  2  2 

OFL  DRIVER 

DB3  2 

• 

RHA 3  2 

OFL  DRIVER 

♦ 

• 

NLO  2 

OFL  DRIVER 

VTO  2 

OFL  DRIVER 

RDO  2 

ONL  DRIVER 

VMR> 

VMRXCON 

DIS  CPU 

CPA 

VMRVCON 

DIS  FUL 

CPA 

RHA 

OFL 

CPA 

CSR=1 76700 

VEC=2 54  PRI 

=  5 

RHB 

OFL 

CPA 

CSR=1 76300 

VEC=150  PRI 

=  5 

RHC 

OFL 

CPA 

CSR=1 72040 

VEC=204  PRI 

=  5 

RHD 

• 

OFL 

CPA 

CSR=1 72440 

VEC=224  PRI 

=  5 

• 

DBO  2 

RHAO  2 

OFL  DRIVER 

DB1 2 

RHA1 : 

OFL  DRIVER 

DB2  2 

RHA  2  2 

OFL  DRIVER 

DB3  2 

RHA  3  2 

OFL  DRIVER 
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CON  (Cont.) 


NLO : 

OFL 

DRIVER 

VTO: 

OFL 

DRIVER 

RDO : 

ONL 

DRIVER 

VMR> 

Multiprocessor  Systems 

VMR>C CONFIGURATION  DISPLAY  CONTROLLERS  FOR  RH 


RHB 

OFL 

CPA 

CSR=1 76300 

VEC=1 50 

PRI=5 

RHC 

OFL 

CPA 

CSR=1 76700 

VEC=2  54 

PRI=5 

RHD 

OFL 

CPA 

CSR=1 72440 

VEC=224 

PRI  =  5 

RHH 

OFL 

CPB 

CSR=1 76700 

VEC=254 

PRI=5 

RHM 

OFL 

CPC 

CSR=1 76700 

VEC=254 

PRI=5 

RHN 

OFL 

CPC 

CSR=1 72440 

VEC=224 

PRI=5 

RHR 

OFL 

CPD 

CSR=1 76300 

VEC=1 50 

PRI  =  5 

RHS 

OFL 

CPD 

CSR=1 76700 

VEC=254 

PRI=5 

VMR>CON  DIS  CPU 

CPA 

CPB 

CPC 

CPD 

VMR>CON  DIS  FULL 

CPA 

CPB 

CPC 

CPD 


« 

BSO :  BSAO :  BSBO:  OFL  DRIVER 

BS1 :  BSCO:  BSDO:  BSEO:  BSFO:  OFL  DRIVER 


DBO:  RHHO :  RHMO :  OFL  DRIVER 


VMR>CON 

DIS  FOR 

YH 

YHA 

OFL 

CPA 

CSR=1 60020 

VEC=3 1 0 

PRI=5 

YHB 

OFL 

CPA 

CSR=1 60040 

VEC=3  20 

PRI=5 

YHC 

VMR> 

OFL 

CPA 

CSR=1 60060 

VEC=330 

PRI=5 

Format  2 


CON 

SET 

controller-name 

CSR=value 

or 

CON 

SET 

controller-name 

VEC=value 

Parameters 


controller-name 

The  name  of  the  controller  for  which  the  CSR  or  vector  address  is 
to  be  changed. 
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DEV 


DEVICES 

Use  the  DEVICES  command  to  display  the  symbolic  names  of  all  device 
units  or,  optionally,  all  of  a  particular  device  type  defined  in  the 
system  image.  The  device  names  appear  in  a  single  vertical  column.  A 
second  column  contains  any  additional  information  about  each  device. 

Format 

DEVfICES]  [dd : ] 

Parameter 
dd  : 


The  particular  device  type  to  be  displayed.  If  you  omit  this 
parameter,  the  symbolic  names  of  all  device  units  are  displayed. 

Examples 


VMR>DEV 

LPO 

Loaded 

DBO 

Loaded 

DB1 

Loaded 

DB2 

Loaded 

DDO 

Loaded 

DD1 

Loaded 

DKO 

Loaded 

DK1 

Loaded 

DK2 

Loaded 

DK3 

Loaded 

DLO 

Loaded 

DL1 

Loaded 

DL2 

Loaded 

DM0 

Loaded 

DM1 

Loaded 

DM2 

Loaded 

DRO 

Loaded 

DR1 

Loaded 

DSO 

Of f 1 ine 

DS1 

Of f 1 ine 

DTO 

Loaded 

DTI 

Loaded 

DXO 

Loaded 

DX1 

Loaded 

EMO 

Unloaded 

MMO 

Loaded 

MM1 

Loaded 

COO 

TTO: 

TTO 

Loaded 

TT1 

Loaded 

TT2 

Loaded 

TT3 

Loaded 

TT4 

Loaded 

Loaded 

Loaded 
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DEV  (Cont.) 


NLO : 

TIO: 

CLO:  LPO : 

LBO :  DRO: 

SYO:  DRO: 

VMR> 

Notes 


Note  that  the  pseudo  device  SY:  is  not  redirected  to  the  booted 
device  until  the  system  is  booted. 

The  following  list  describes  the  messages  that  can  appear  in  the 
second  column.  More  than  one  message  can  appear  on  the  same 
1  ine . 

•  On  RSX-1 1M ,  OFFLINE  indicates  that,  although  the  system 
tables  contain  entries  for  the  device,  the  system  as 
saved  did  not  contain  the  related  device. 

f  . . '.-.-I.  ■  - . 


•  On  RSX-1 1M-PLUS ,  OFFLINE  indicates  that  a  device  has  yet 
to  be  brought  on  line  by  the  reconfiguration  task.  All 
physical  devices  will  have  this  attribute. 


•  LOADED  indicates  that 

the 

driver 

for 

the 

device 

is 

loadable 

and  is  currently  loaded. 

•  UNLOADED 

indicates  that 

the 

driver 

for 

the 

device 

is 

loadable  and  is  currently  not  loaded. 


•  A  device  name  in  the  second  column  is  the  device  to  which 
the  corresponding  device  in  the  first  column  has  been 
redirected . 

•  The  absence  of  either  LOADED  or  UNLOADED  in  the  second 
column  indicates  that  the  driver  is  permanently  resident; 
it  is  linked  to  the  Executive. 
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FIX- IN-MEMORY 

Use  the  FIX-IN-MEMORY  command  to  load  a  task  or,  on  RSX-11M-PLUS 
systems,  a  region  into  its  partition  in  the  system  image.  The  system 
can  service  requests  for  running  the  task  more  quickly  because  the 
task  is  memory-resident  and  does  not  have  to  be  loaded  from  the  disk 
before  it  can  run. 

VMR  can  fix  a  task  in  the  system  image  only  if  the  partition  in  which 
it  is  to  be  fixed  is  available.  (On  RSX-11S  systems,  all  installed 
tasks  must  be  fixed  since  they  cannot  be  loaded  into  the  running 
RSX-11S  system.) 

Fixed  tasks  remain  in  memory  even  after  they  exit.  Therefore,  they  do 
not  have  to  be  reloaded  when  a  request  is  made  to  run  them.  However, 
note  that  reexecuting  fixed  tasks  is  not  always  practical.  If  you 
expect  to  reexecute  a  fixed  task,  you  should  write  it  such  that  it 
initializes  all  impure  data  and  LUN  assignments  at  run  time. 

Only  an  UNFIX  or  REMOVE  command  can  free  the  occupied  partition. 

The  following  restrictions  apply  to  the  fixing  of  tasks: 

•  On  RSX-11M  systems,  checkpointable  tasks  cannot  be  fixed.  On 
RSX-11M-PLUS  systems,  checkpointable  tasks  should  not  be  fixed 
because  fixing  a  checkpointable  task  makes  the  task 
noncheckpo in table . 


•  On  RSX-11M-PLUS  systems,  tasks  whose  names  are  in  the  form 
...xxx  and  xxx$$$  cannot  be  fixed  because  that  copy  of  the 
task  is  never  executed.  (The  task  is  a  prototype  task.) 

•  Active  tasks  cannot  be  fixed. 

•  A  task  must  be  installed  before  it  can  be  fixed. 

Format 

FIX  taskname [/keyword] 

Parameter 

taskname 


The  task  or  region  that  you  wish  to  fix  in  memory.  If  you  do  not 
specify  a  keyword,  VMR  assumes  that  the  task  is  a  single-user 
task . 


/keyword 

One  of  the  following  keywords  (RSX-11M-PLUS  systems  only) : 

/DIR 

/NSF 

/REG 

/RON 
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/DIR 

Specifies  that  the  task  to  be  fixed  is  a  directive  common. 

Directive  commons  are  used  to  hold  some  of  the  Executive 
directives  instead  of  the  directives  being  kept  in  executive 
addressing  space.  Because  the  commons  contain  Executive  code, 
they  must  be  installed  and  fixed  in  the  system  image  before  the 
system  can  be  booted. 

The  commons  are  installed  and  fixed  in  the  system  image  by 
commands  in  SYSVMR.CMD  as  part  of  the  system  generation 
procedure.  There  are  two  directive  commons  used  by  RSX-11M-PLUS : 
DIR11M  and  DR211M.  These  commons  are  installed  and  fixed 
automatically  by  SYSVMR.CMD  during  system  generation.  DIR11M 
must  be  fixed  in  memory  before  any  other  directive  commons  can  be 
fixed.  Other  directive  commons  must  be  fixed  contiguously  to 
DIR11M. 

Directive  commons  are  nonshuf f leable ,  that  is,  the  shuffler 
cannot  move  them  around  in  memory  after  they  have  been  fixed. 

To  eliminate  the  directive  commons,  use  the  REMOVE  command. 

/NSF 

Specifies  that  the  task  to  be  fixed  will  be  nonshuf f leable .  The 
shuffler  will  not  be  able  to  move  the  tasks  around  in  memory 
after  the  task  has  been  fixed. 

For  information  about  the  shuffler,  see  Chapter  14. 


/REG 


Specifies  that  the  task  to  be  fixed  is  a  common  region, 

/RON 

Specifies  that  the  task  to  be  fixed  is  a  multiuser 

task,  the 

read-only  portion  of  which  is  to  be  fixed  in  memory 

.  You  must 

specify  the  entire  task  name. 

Examples 

VMR>FIX  XKE 

Fixes  task  XKE  in  its  partition. 

■|  vmr>fix 

Fixes  resident  common  TTCOM  in  its  partition  and  spec 

ifies  that 

the  task  will  be  nonshuf f leable . 

VMR>FIX  ...EDI/RON 

The  editor  EDI  is  built  as  a  multiuser  task.  This  command  line 

fixes  its  read-only  portion  in  its  partition. 
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INSTALL 

Use  the  INSTALL  command  to  make  a  specified  task  known  in  the  system 
image  or,  on  RSX-11M  systems,  to  load  a  common  into  a  common 
partition.  An  installed  task  is  dormant  until  the  Executive  receives 
a  request  to  run  it.  The  optional  keywords  either  provide  parameters 
that  were  not  specified  at  task-build  time  or  override  parameters  that 
were  specified. 

When  a  task  is  installed,  VMR  creates  a  Task  Control  Block  (TCB)  for 
the  task  in  a  system  image  table  called  the  System  Task  Directory 
(STD) .  The  task  parameters  contained  in  the  TCB  enable  the  system  to 
run  the  task  when  requested  to  do  so  by  an  MCR  command,  VMR  command, 
or  a  system  directive.  A  task  cannot  be  run  until  you  install  it. 

A  TCB  contains  the  address  of  the  load-device  Unit  Control  Block  (UCB) 
and  the  Logical  Block  Number  (LBN)  of  the  task  image  file.  Because 
task  image  files  are  contiguous,  the  Executive  can  load  the  task  image 
in  one  transfer  when  an  MCR  command  or  system  directive  requests  an 
installed  task.  (Loading  requires  more  than  one  transfer  if  the  task 
is  larger  than  32K  words.) 

When  VMR  installs  a  task  in  a  virgin  system,  it  stores  the  task's  LBN 
in  the  TCB.  When  you  save  a  system,  the  SAVE  command  places  the  file 
identification,  rather  than  the  file's  LBN,  in  the  TCB.  When  the 
system  is  rebooted,  it  opens  the  task  file  and  stores  the  task's  new 
LBN  in  its  TCB.  if  a  task  has  been  deleted,  the  system  cannot  open 
the  task  file  when  the  system  is  rebooted.  The  system  then 
automatically  removes  the  task's  TCB  from  the  STD. 

When  VMR  installs  a  task  in  a  saved  system  image,  it  stores  the  task's 
file  identification,  rather  than  the  LBN,  in  the  TCB  to  allow  a  reboot 
to  occur  successfully.  It  is  important  that  a  saved  system  image  not 
retain  the  physical  disk  addresses  of  the  installed  tasks  because  the 
Disk  Save  and  Compress  utility  Program  (DSC)  or  the  Backup  and  Restore 
Utility  (BRU)  can  compress  and  copy  a  disk  containing  a  saved  system, 
thus  moving  the  task  files  to  different  physical  locations.  Because 
the  TCB  entries  contain  task  file  identifications  rather  than  LBNs , 
the  system  can  function  normally  when  it  is  rebooted. 

Format 

INS (TALL)  filespec [/keyword (s) ] 

Parameters 

filespec 

A  task  image  file  specification  in  the  form: 
ddnn : [g ,m] filename .type /version 

The  ddnn:  specification  defaults  to  LB:  and  the  type  defaults 
to  TSK.  Standard  defaults  apply  to  the  remaining  fields. 
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/keyword  ( s) 

One  or  more  of  the  following  keywords:. 


/AFF= [urm] 

/CKP=opt ion 
/CLI=option 
/FIX=opt ion 
/INC=si ze 
/IOP=opt ion 
/PAR=pname 
/PMD=opt ion 
/PRI=number 

/PRO= [system  f owner  ,group  ,world] 


/RON=opt ion 
/ROPAR=pname 
/SEC=option 
/SLV=opt ion 
/TASK=taskname 
/UIC=  [group  ,member] 
/XHR=opt ion 


Keywords 

/AFF=processor  or  / AFF=urm ( s) 

(RSX-1 1M-PLUS  multiprocessor  systems  only.)  The  processor  or 
UNIBUS  Run  Mask  affinity  of  the  task.  The  square  brackets  are 
required  syntax.  You  must  specify  at  least  one  URM.  If  you 
specify  more  than  one  URM,  you  must  separate  them  by  commas.  The 
legal  processor  specifications  are: 

CPA 

CPB 

CPC 

CPD 

The  legal  URM  specifications  are: 


UBE 

UBK 

UBP 

UBF 

UBL 

UBR 

UBH 

UBM 

UBS 

UBJ 

UBN 

UBT 

When  you  specify  the  /AFF  keyword,  the  installed  task  runs  only 
on  the  processor  to  which  the  specified  URMs  are  connected. 

/CKP=opt ion 

The  checkpointability  of  the  task  on  systems  that  support  the 
dynamic  allocation  of  checkpoint  space.  The  options  are  YES  and 
NO.  If  /CKP=YES  (default  for  checkpointable  tasks) , 
checkpointing  is  enabled  for  the  task.  If  /CKP=NO,  checkpointing 
is  disabled  for  the  task. 

The  /CKP  keyword  overrides  the  /CP  switch  specified  at  task 
build . 

The  task  image  file  need  not  contain  allocated  checkpoint  space. 
The  /CKP=YES  keyword  instructs  the  system  to  allocate  checkpoint 
space  for  the  task,  when  required,  from  a  checkpoint  file. 
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On  RSX-11M  systems,  if  a  task  was  built  with  the  /XH  switch,  the 
/ CKP  keyword  is  disabled  for  that  task. 

Default:  /CKP=YES. 

/CLI=option 

Specifies  that  the  task  being  installed  is  a  command  line 
interpreter  (CLI) .  The  options  are  YES  and  NO.  You  must  install 
a  CLI  with  the  YES  option  before  you  can  set  a  terminal  to  that 
CLI  (MCR  SET  /CLI)  or  work  with  the  CLI  by  means  of  the  MCR  CLI 
command . 

/FIX=opt ion 

(RSX-11S  systems  only.)  Specifies  whether  memory-resident  tasks 
on  RSX-11S  will  be  fixed  in  memory.  The  options  are  YES  and  NO. 
When  you  specify  /FIX=YES,  the  task  is  both  installed  and  fixed 
in  memory. 

/INC=si ze 


(Mapped  systems  only.)  The  extension  size;  that  is,  the  number 
of  additional  words  of  address  space  to  be  allocated  to  a  task 
that  runs  in  a  system-controlled  partition.  The  extension  size 
is  usually  expressed  in  octal  but  may  also  be  expressed  in 
decimal  by  appending  a  period  (•) •  This  keyword  overrides  the 
Task  Builder's  EXTTSK  or  PAR  options. 

Tasks  such  as  MAC,  TKB ,  PIP,  VFY ,  and  AT.  (Indirect)  use  the 
space  from  the  end  of  the  task  image  to  the  end  of  their  address 
space  as  dynamic  memory  in  which  to  allocate  symbol  tables  and 
buffers.  The  /INC  keyword  defines  the  number  of  words  in  this 
dynamic  region. 

Default:  the  size  specified  at  task-build  time  or  zero  (0). 
/IOP=opt ion 

Specifies  that  a  privileged  task  can  overmap  the  I/O  page.  The 
options  are  YES  and  NO.  If  /IOP=YES,  INSTALL  assumes  that  the 
task  will  overmap  the  I/O  page  (APR  7)  and,  if  the  task  is  larger 
than  8K  words,  issues  a  warning  message.  If  /IOP=NO,  INSTALL 
assumes  that  the  task  does  not  need  to  use  the  I/O  page.  No 
warning  message  is  issued. 

The  /IOP  keyword  complements  the  Task  Builder  /IP  switch. 
Specifying  /IP  informs  INSTALL  that  the  task  is  intentionally 
overmapping  the  I/O  page. 

Default:  /I0P=YES. 

/PAR=pname 


A  partition  name  that  overrides  the  partition  specified  at 
task-build  time. 


On  RSX-11M  systems,  if  the  partition  specified  for  the  task  is  i 
user-controlled  partition,  the  size  of  the  task  is  extended  tc 
the  size  of  the  partition.  Consequently,  if  the  task  is  buill 
Wlt^  ?hec*Point  space  allocated  in  the  task  image  file  and  the 
partition  is  extended  (thereby  extending  the  size  of  the  tasl 
when  it  is  reinstalled),  the  allocated  checkpoint  space  may  nc 
longer  be  large  enough  to  hold  the  task. 
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If  the  keyword  specifies  a  nonexistent  partition,  VMR  issues  a 
warning  message  and  attempts  to  install  the  task  in  the  GEN 
partition . 

Default:  the  Task  Builder  uses  the  name  GEN.  (See  the  RSX-11M 

or  RSX-1 1M- PLUS  System  Generation  and  Installation  Guide  for  an 
explanation  of  multiuser  system  defaults.) 

/PMD=option 

Specifies  whether  a  Postmortem  Dump  is  required.  The  options  are 
YES  and  NO.  If  /PMD=YES ,  the  system  will  perform  a  Postmortem 
Dump  of  the  task  if  it  aborts  the  task  because  of  an  SST  error 
condition.  If  /PMD=NO  (the  default  from  a  task  build) ,  the 
system  will  not  perform  a  dump  following  an  SST  abort.  To 
generate  a  dump,  you  must  install  the  Postmortem  Dump  task  PMD. • • 
in  the  system.  This  keyword  overrides  the  Task  Builder's  /PM 
switch . 

Default:  specified  at  task-build  time. 

/PRI=number 

The  installed  priority  of  the  task.  The  number  is  the  priority 
at  which  the  task  is  to  be  installed.  The  value  range  is  1 
through  250(10),  where  250  is  the  highest  priority.  Standard 
RSX-1 1M/M-PLUS  number  conventions  apply  to  this  parameter:  octal 
by  default,  decimal  if  followed  by  a  period. 

Default:  PRI=50(10) . 

/PR0= [system ,owner ,g roup , wo  rid] 

(RSX-1 1M-PLUS  systems  only.)  The  protection  mask  for  a  common. 
The  square  brackets  are  required  syntax. 

A  task  linked  to  a  common  region  with  improper  access  cannot  be 
installed . 

The  user  categories  are  defined  as: 

System 

All  system  tasks  running  under  a  UIC  group  number  less 
than  or  equal  to  10(8). 

Owner 

Tasks  that  run  under  the  same  UIC  as  the  file's  owner. 

Group 

Any  task  that  is  running  under  the  same  UIC  group  as 
the  file's  owner . 

World 

Any  task  that  does  not  fit  in  one  of  the  above 
categories . 
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The  /PRO  keyword  establishes  the  access  rights  for  each  category. 
If  an  access  code  is  not  specified,  the  access  that  the  code 
represents  is  denied.  The  four  access  codes  are: 

•  Read 

•  Write 


•  Extend 


•  Delete 

Default:  /PRO= [RWED, RWED, RWED, RWED] . 

Note  that  you  cannot  specify  protection  options  for  a  read-only 
common  region  or  the  read-only  portion  of  a  multiuser  task. 

/RON=opt ion 

( RSX-1 1M-PLUS  systems  only.)  Establishes  whether  a  common  region 
IS  to  be  read-only.  The  options  are  YES  and  NO.  If  /RON=YES , 
the  region  is  installed  as  read-only.  if  /RON=NO,  the  region  is 
installed  with  read/write  access.  This  keyword  overrides  the 
effect  of  the  /PRO  keyword. 

Default:  /RON=NO;  the  region  is  installed  with  read/write 
access . 

/ROPAR=pname 

(RSX-11M-PLUS  systems  only.)  The  read-only  partition  into  which 
the  read-only  portion  of  a  multiuser  task  is  to  be  installed. 
The  pname  is  the  name  of  a  read-only  system  partition.  This 
keyword  overrides  the  Task  Builder  options.  if  the  named 
partition  does  not  exist,  VMR  issues  a  warning  message  and 
attempts  to  install  the  read-only  portion  of  the  task  into  the 
partition  containing  the  read/write  portion  of  the  tasx. 

Default:  specified  at  task-build  time. 

/ SEC=option 

(RSX-1 1M-PLUS  systems  only.)  Places  the  Task  Control  Block  (TCB) 
for  the  task  being  installed  in  secondary  pool.  The  keyword  is 

legfLonly  for  tasks  whose  names  are  ^  the  form  ...xxx  or 
xxx$$$.  The  options  are  YES  and  NO.  If  /SEC=NO,  the  TCB  for  the 
task  is  placed  in  primary  pool  instead  of  secondary  pool. 

Default:  the  TCB  is  placed  in  secondary  pool. 

/SLV=opt ion 


The  task's  slave  status.  The  options  are  YES  and  NO.  If  the 

command  specifies  /SLV=YES,  data  sent  to  the  installed  task  is 

marked  with  the  TI:  of  the  sending  task.  When  the  installed 

task  receives  the  data,  the  system  sets  the  task's  TI:  to  that 

Bunrtpr^d/^th  data*  This  keyword  overrides  the  Task 

Builder's  /SL  switch. 


If  you  specify  /SLV=NO,  the  TI: 
the  task  receives  data. 


of  the  task  does  not  change  when 
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On  RSX-11M-PLUS,  the  /SLV  keyword  cannot  be  used  with  tasks  whose 
names  are  in  the  form  .  ..xxx.  These  tasks  are  prototype  tasks 
and  cannot  be  installed  as  slaved  tasks. 

Default:  specified  at  task-build  time. 

/SYNC=opt ion 

( RSX-1 1M-PLUS  multiprocessor  systems  only.)  Synchronizes  task  use 
of  a  common.  The  options  are  YES  and  NO.  This  keyword  permits 
several  tasks  to  share  a  common  and  use  the  common  for 
synchronization.  If  /SYNC=YES  for  two  or  more  tasks,  only  one  of 
the  tasks  can  execute  at  one  time.  If  one  of  the  tasks  becomes 
blocked,  the  others  compete  to  execute. 

The  /SYNC  keyword  prevents  inconsistent  data  that  occurs  as  the 
result  of  race  conditions.  For  example,  if  two  tasks  access  a 
common,  the  /SYNC  keyword  ensures  that  only  one  task  executes  at 
one  time.  This  prevents  the  second  task  from  reading  or  writing 
the  common  while  the  first  task  is  executing. 

Default :  /SYNC=NO. 

/TASK=taskname 

The  name  to  be  used  to  install  the  task. 

Default:  the  name  specified  at  task-build  time  or  the  first  six 
characters  of  the  file  name.  (See  the  RSX-1 1M  or  RSX-1 1M-PLUS 
System  Generation  and  Installation  Guide  for  an  explanation  of 
mul ti user  system  defaults.) 

/UIC= [group ,member] 

The  UIC  for  the  task.  The  square  brackets  are  required  syntax. 
You  can  also  override  the  UIC  with  the  RUN  command. 

The  task  UIC  determines  the  file-protection  class  ( system ,  owner , 
group,  world)  to  which  a  task  belongs  and  thus  directly 
influences  file  access.  Note  that  file  protection  may  differ 
from  file  to  file. 

Default:  specified  at  task-build  time.  This  default  applies 
only  to  tasks  started  by  a  RUN$  directive  or  a  RUN  command  that 
specifies  a  time  delay  before  run  time.  Tasks  started  by  typing 
the  name  as  a  command  (for  example,  PIP  and  TKB)  run  under  the 
default  UIC  of  the  terminal  from  which  the  command  was  issued. 

/XHR=opt ion 

( RSX-1 1M-PLUS  systems  only.)  Specifies  that  the  Executive's  copy 
of  the  task's  header  will  be  in  an  area  external  to  the  system's 
dynamic  storage  area  (pool) . 

When  you  specify  /XHR=YES ,  the  task's  header  is  not  kept  in  pool. 
Instead,  a  copy  of  the  header  is  placed  in  a  reserved  area 
immediately  below  the  task  image.  The  Executive  uses  the  copy  of 
the  header  rather  than  the  actual  header.  When  the  task  is 
checkpointed,  the  system  writes  the  task  image  and  the  copy  of 
the  header  into  the  checkpoint  file.  The  header  in  the  task 
image  is  left  unchanged. 
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The  options  are  YES  and  NO.  If  /XHR=YES ,  the  task  is  installed 
with  an  external  header.  if  /XHR=NO,  the  task  is  installed  with 
a  resident  header. 

The  /XHR  keyword  correlates  with  the  /XH  option  for  the  Task 
Builder.  The  default  for  /XHR  and  the  ability  for  a  user  to 
override  the  option  specified  at  task-build  time  depend  on  how 
the  INSTALL  task  was  built  at  system  generation.  See  your  system 
manager  for  this  information.  1  y 

Examples 

VMR>INSTALL  SCAN 

Installs  task  SCAN  using  the  default  priority  and  UIC. 

VMR> INSTALL  DM1 : [1,111] SCAN. TSK; 4/PR 1=1 03 

Installs  task  SCAN,  file  type  .TSK,  version  4,  from  device  DM1:, 
group  number  1,  member  number  111,  with  a  priority  of  103(8). 

VMR>INS  MAC/ INC=4096 ./PAR=SYSCTL 

Installs  task  MAC  in  the  partition  SYSCTL  and  increases  the  task 
size  by  4096(10)  words. 
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LOAD 

into  the 
ident  data 
el iminates 
y  into  the 

Executive . 


Use  the  LOAD  command  to  load  a  nonresident  device  driver 
system  image.  LOAD  either  links  a  driver  to  an  already  re 
base  or  makes  a  loadable  data  base  resident.  This  command 
the  need  to  link  infrequently  used  device  drivers  permanent 


Executive  support  of  loadable  device  drivers  is  a  system  generation 
option  on  RSX-11M  but  is  always  included  on  RSX-11M-PLUS. 

Format 


LOA [D]  dd : [/keyword ( s) ] 


Parameters 
dd  : 


A  2-character  ASCII  device  name. 


/keyword  ( s) 

One  or  two  of  the  following  keywords: 


/CTB=cc[a,b, . . .]  (RSX-1 1M-PLUS  only) 


/PAR=pname 
/SIZ  E=psi ze 
Keywords 
/CTB=cc [ a ,b , . . .] 

( RSX-1 1M-PLUS  systems  only.)  The  cc  is  the  name  of  the 
multidriver  controller  ( CTB)  that  should  be  used  instead  of 
$ddCTB  in  the  loadable  data  base.  [a,b,...]  are  slots  in  the 
CTB 1  s  KRB  table  that  should  point  at  the  KRBs  \in  the  loadable 
data  base.  The  slots  are  named  A,B,C,DrErF,H,JrK,L,M,N,PrR,Sr 
and  T. 

The  /CTB  keyword  is  used  to  load  a  driver  that  references  a  split 
data  base.  Refer  to  the  RSX-1 1M-PLUS  Guide  to  Writing  an  I/O 
Driver  for  more  information. 

/PAR=pname 

The  partition  into  which  the  driver  is  to  be  loaded.  The  pname 
is  a  partition  name.  The  /PAR  keyword  overrides  the  partition 
specified  at  task-build  time. 


/SIZ  E=psi ze 


The  minimum  size  (octal  words)  of  the  partition  into 
driver  is  to  be  loaded.  The  psize  is  the  partition 
rounds  psize  up  to  the  next  largest  unit  of  100(8). 
be  less  then  77741. 


which 
size . 
Psi  ze 


the 

VMR 

must 
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Examples 

VMR>LOAD  MM: 

Loads  the  TU16  driver  ( MMDRV) . 

VMR>LOA  DK : /PAR=DRVPAR 

Loads  the  RK05  driver  ( DKDRV)  into  DRVPAR. 

VMR> LOA  DR : / CTB=RHB 

Loads  the  RM03  driver  (DRDRV) ,  using  the  RHB  multidriver 
controller . 


Notes 

1.  Guidelines  for  building  user-written  loadable  device-driver 
tasks  are  defined  in  the  RSX-11M  and  RSX-11M-PLUS  Guide  to 
Writing  an  I/O  Driver . 

2.  The  LOAD  command  requires  that  a  driver* s  .TSK  and  .STB  files 
reside  in  the  same  UFD  and  on  the  same  disk  as  the  system 
image  upon  which  you  are  working.  For  example,  the  following 
command  requires  that  the  files  DTDRV.TSK  and  DTDRV. STB 
reside  on  SY:  under  the  current  UIC: 

LOA  DT: 

3.  The  LOAD  command  requires  pool  space  as  follows: 

a.  If  the  driver  data  base  is  being  loaded,  the  data  base 
needs  contiguous  pool  space  equal  to  its  size. 

b.  In  a  mapped  system,  each  interrupt  entry  in  the  driver 
needs  pool  space  for  an  Interrupt  Control  Block  (ICB)  . 

c.  If  the  driver  is  being  loaded  into  a  system-controlled 
partition,  the  Partition  Control  Block  (PCB)  needs  pool 
space . 
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c 


LUN 


LOGICAL  UNIT  NUMBERS 

Use  the  LUN  command  to  display  the  static  LUN  assignments  for  a 
specified  task.  Static  assignments  are  those  recorded  in  the  task's 
disk  image  file  (for  example,  those  assignments  specified  at 
task-build  time).  The  display  consists  of  a  list  of  physical  device 
units  in  one  column  and  their  corresponding  LUNs  in  an  adjoining 
column. 

Format 

LUN [S ]  taskname 
Parameter 
taskname 

The  task  for  which  the  LUNs  are  to  be  displayed. 

Example 

VMR>LUN  XKE 
SYO:  1 

SYO:  2 

CLO:  3 

TT3 :  4 

TT3 :  5 

DKO :  6 

TT3 :  7 

The  display  shows  static  assignments  for  LUNs  1  through  7  as 
recorded  in  the  task  image  file  header.  No  other  LUNs  are 
statically  assigned  to  the  task  XKE. 


c 


c 
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PARTITION  DEFINITIONS 

Use  the  PAR  command  to  display  a  description  of  each  memory  partition 
in  the  system  image.  The  display  consists  of  six  columns  that 
specify: 

1.  Partition  name 

2.  Partition  Control  Block  address  (octal) 

3.  Partition  base  address  (octal) 

4.  Partition  size  (octal) 

5.  Partition  type 

6.  Name  of  partition  occupant(s)  —  task,  driver,  common,  and  so 
forth . 


On  RSX-11M-PLUS,  the  symbols  accompanying  the  name 
following  meanings : 

have  the 

<  >  active  task 

[  ]  in  memory  but  inactive 

+  +  multiuser  tasks  ( 

read-on 

ily  sections) 

111  lliilliilllli!  111!! ! 

!  !  read-write  named 

commons 

(  )  driver 

Format 

PARTITIONS] 

Example  (of  a  saved  system) 


Name 

PCB 

Base 

Si  ze 

PAR/TASK  Name 

VMR>PAR 

SYS PAR 

035720 

00200300 

00010000 

MAIN 

SPLPAR 

035654 

00210300 

00013000 

MAIN 

DRVPAR 

035610 

00223300 

00140000 

MAIN 

035324 

00223300 

00003500 

DRIVER 

(DB:) 

035260 

00227000 

00001300 

DRIVER 

(DK:) 

035214 

00230300 

00003600 

DRIVER 

(DR:) 

035150 

00234100 

00001600 

DRIVER 

(DS:) 

035104 

00235700 

00004200 

DRIVER 

(DM: ) 

034774 

00246400 

00001300 

DRIVER 

(DT:) 

034730 

00247700 

00001600 

DRIVER 

(DX:) 

034664 

00251500 

00001200 

DRIVER 

(LP:) 

034620 

00252700 

00035500 

RW  COM 

! TTCOM  ! 

034534 

00310400 

00020000 

DRIVER 

(TT:) 

034470 

00330400 

00001400 

DRIVER 

(RD:) 

034424 

00332000 

00001300 

DRIVER 

(VT: ) 

034360 

00333300 

00003100 

DRIVER 

(CO:) 

034314 

00336400 

00000100 

DRIVER 

(NL:) 

035040 

00336500 

00004400 

DRIVER 

(MM:) 
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LDRPAR 

TSTPAR 

SECPOL 

GEN 

VMR> 


PAR  (Cont.) 


035544 

00363300 

00003000 

MAIN 

033774 

00363300 

00003000 

TASK 

<LDR. . . 

> 

035500 

00366300 

00040000 

MAIN 

036454 

00366300 

00040000 

TASK 

<SAVT0 

> 

035434 

00426300 

00050000 

SEC 

POOL 

035370 

00476300 

04701500 

MAIN 

VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


REA 


REASSIGN 

Use  the  REASSIGN  command  to  reassign  a  task's  logical  unit  numbers 
(LUNs)  from  one  physical  device  unit  to  another •  The  reassignments 
affect  only  the  static  assignments  recorded  in  the  task's  disk  imaqe 
file. 

The  command  does  not  affect  a  memory-resident  task.  Therefore, 
REASSIGN  has  no  effect  on  the  assignments  for  a  task  that  is  fixed  or 
loaded  in  memory. 

Format 

REA [SS IGN]  taskname  lun  new: 

Parameters 

taskname 

The  name  of  the  task  for  which  the  LUNs  are  to  be  reassigned. 


lun 


The  logical  unit  number. 

new: 

The  new  device  unit,  which  can  be  a  physical,  logical,  or  pseudo 
device . 

Examples 

VMR>REA  LODN  3  TTO : 

Reassigns  LUN  3  of  task  LODN  to  physical  device  TTO:. 

VMR>REA  TEST  3  XX: 

Reassigns  LUN  3  of  task  TEST  to  logical  device  XX:. 
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RED 


REDIRECT 


Use  the  REDIRECT  command  to  redirect  all  I/O  requests 
physical  device  unit  to  another  physical  device  unit. 


from  one 


Note  that  an  attached  device  and  the  pseudo  device  TI:  cannot  be 
redirected.  In  addition,  one  pseudo  device  cannot  be  redirected  to 
another  pseudo  device. 


Format 


REDIRECT]  new:  =old  : 
Parameters 
new: 


The  new  device  unit  to  which  requests  will  be  redirected. 

old  : 

The  old  device  unit  from  which  requests  will  be  redirected. 
Examples 

VMR>RED  TT3 : =TT6 : 

Redirects  all  I/O  requests  for  device  TT6 :  to  device  TT3 : • 
VMR>RED  TT : =LP: 

Redirects  all  I/O  requests  for  device  LPO:  to  device  TTO : . 
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REMOVE 

Use  the  REMOVE  command  to  delete  a  task  name  or,  on  RSX-11M-PLUS 
systems,  a  region  name  from  the  system  task  directory.  Removing  a 
task  from  the  system  image  makes  the  task  unknown  to  the  system.  The 
action  resulting  from  this  command  is  the  complement  of  INSTALL. 

The  REMOVE  command  cannot  remove  an  active  task  from  a  saved  system. 
An  example  of  such  a  task  is  SAV;  an  attempt  to  remove  SAV  from  a 
saved  system  results  in  the  error:  Task  active. 

Formats 

REM [OVE]  name [/REG] 

Parameters 

name 


The  name  of  the  task,  region,  or  directive  common  to  be  removed. 

/REG 

(RSX-11M-PLUS  systems  only.)  Specifies  that  name  is  the  name  of  a 
reg ion . 

You  must  specify  this  keyword  when  removing  the  directive 
commons.  To  remove  the  commons,  use  the  following  command  line: 

VMR>REM  DIR1 1M/REG 

Note  that  when  you  remove  DIR11M,  you  are  removing  all  of  the 
directive  commons  in  the  system. 

Example 

VMR>REM  SCAN 

Removes  the  task  named  SCAN  from  the  system  task  directory.  The 
task  image  file  remains  unaffected. 


Notes 

1.  If  a  task  or  region  that  is  the  object  of  a  REMOVE  command  is 
fixed,  the  command  automatically  unfixes  the  task  from  the 
system  image. 

2.  REMOVE  automatically  cancels  all  time-based  schedule  requests 
for  the  specified  task. 
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To  remove  a  command  line  interpreter  (CLI)  task, 
first  eliminate  the  CPB  for  the  task  with  the  MCR 
command  on  the  running  system.  Then  use  the  MCR  SA 
to  update  the  system  image  file,  invoke  VMR,  and 
CLI.  However,  it  is  recommended  that  you  work 
exclusively  with  MCR  on  the  running  system  —  thi 
eliminating  and  removing  old  CLIs ,  and  insta 
initializing  new  ones  —  and  then  save  the  system. 


you  must 
CLI  /ELIM 
VE  command 
remove  the 
with  CLIs 
s  includes 
ing  and 


11 


An  exception  to  this  note  is  the  primary  MCR  task  (MCR...). 
The  CPB  for  this  task  can  never  be  eliminated  and  the  task 
itself  can  only  be  removed  with  VMR. 
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RUN 

Use  the  RUN  command  to  initiate  the  execution  of  an  installed  task. 
This  command ,  which  has  four  formats,  can  cause  a  task  to  be: 

•  Started  one  clock  tick  after  system  boot 

•  Started  at  a  time  increment  from  the  system  image  time 

•  Started  at  a  time  increment  from  clock  unit  synchronization 


•  Started  at  an  absolute  time  of  day 
All  of  these  options  are  available  with  or  without  rescheduling. 


On  RSX-1 1M-PLUS ,  you  cannot  run  a  task  using  the  ...xxx 

fo  n 

Xi  of 

the 

task  name,  that  is, 

you  cannot  specify  RUN 

. .  .xxx . 

The  . 

.  .xxx 

(and 

xxx$$$)  form  is  used  fo 
never  executed. 

r  the  prototype  copy  o 

f  the 

task , 

which 

is 

Format  1 


RUN  taskname  [/keyword ( s) ] 

Runs  taskname  one  clock  tick  after  system  boot. 

Parameters 

taskname 

The  1-  to  6-character  task  name  of  the  task  that  you  want  the 
system  to  run. 

/keyword  ( s) 

One  or  both  of  the  following  keywords: 

/RSI=magu 
/UIC= [uic] 


Keywords 
/RSI=mag  u 

The  reschedule  interval.  The  format  is  the  same  as  that  for 
dtime,  which  is  detailed  under  Format  2.  The  reschedule  interval 
specifies  how  often  you  want  the  system  to  rerun  the  task.  Each 
time  the  interval  of  time  you  have  specified  lapses,  the  system 
makes  an  initiation  request  for  the  task.  The  default  is  no 
reschedul ing . 

If  the  magnitude  field  is  equal  to  0,  then  the  reschedule 
interval  is  set  to  1.  Specifying  /RSI=0H  is  the  same  as 
specifying  /RSI=1H. 
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/UIC= [ uic] 

The  UIC  under  which  the  task  is  requested.  It  determines  which 
files  the  task  can  access.  The  UIC  is  in  the  format  [g,m],  where 
g  and  m  represent  the  group  and  member  numbers,  respectively. 
Legal  group  and  member  numbers  range  from  1  through  377(8).  The 
square  brackets  are  required  syntax. 

Default:  the  UIC  established  for  pseudo  device  CO:. 


Format  2 

RUN  taskname  dtime  [/keyword ( s) ] 

Runs  taskname  at  a  time  increment  from  the  system  image  time. 
Parameters 
taskname 

The  1-  to  6-character  task  name. 


dtime 

The  time  at  which  the  task  is  initiated  in  time  units  from  the 
current  system  image  time.  It  has  the  form: 

magu 

mag 

The  magnitude,  which  is  the  number  of  units  to  be  clocked. 
The  magnitude  value  cannot  exceed  24  hours  in  the  specified 
unit  and  is  decimal  by  default. 


u 


Time  units  specified  as  follows: 

T  for  ticks.  A  tick  is  a  clock  interrupt.  The  rate  at  which 
interrupts  occur  depends  on  the  type  of  clock  installed  in 
the  system. 

For  a  line  frequency  clock,  the  tick  rate  is  either  50  or 
60  ticks  per  second,  corresponding  to  the  line  frequency. 

For  a  programmable  clock,  a  maximum  of  1000  ticks  per 
second  is  available.  (The  frequency  is  selected  at  system 
generation.) 

T  can  be  any  positive  value  up  to  a  maximum  of  15  bits. 

S  for  seconds.  S  can  be  any  positive  value  up  to  a  maximum 

of  15  bits. 

M  for  minutes.  M  can  by  any  positive  value  from  0  through 

1440(10)  . 

H  for  hours.  H  can  by  any  positive  value  from  0  through 

24(10)  . 
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/keyword  ( s) 

One  or  both  of  the  following  keywords: 

/RSI=magu 
/UIC= [uic] 

These  keywords  are  described  under  Format  1. 

Format  3 

RUN  taskname  sync  [dtime] [/keyword ( s) ] 

Runs  taskname  at  a  time  increment  from  clock  unit 
synchroni zation . 

The  system  determines  the  task  start-time  by  waiting  for  the 
specified  time  unit  (sync)  to  increment  and  then  waitinq  for  the 
specified  time  (dtime)  to  elapse. 

Parameters 

taskname 

The  1-  to  6-character  task  name. 

sync 


The  synchronization  unit.  Permissible  values  are: 

H  -  Synchronize  on  the  next  hour 

M  -  Synchronize  on  the  next  minute 

S  -  Synchronize  on  the  next  second 

T  -  Synchronize  on  the  next  tick 


d  time 


The  value  of  dtime,  if  present,  is  added  to  the  synchronization 
unit  to  produce  the  actual  run  time  for  running  the  task.  The 
format  for  specifying  dtime  is  given  in  Format  2. 

/keyword  ( s) 

One  or  both  of  the  following  keywords: 

/RSI=magu 
/UIC= [ uic] 

These  keywords  are  described  under  Format  1. 

Format  4 


RUN  taskname  atime  [/keyword ( s) ] 

Runs  taskname  at  an  absolute  time  of  day. 
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Parameters 

taskname 

The  1-  to  6-character  task  name. 


at  ime 


The  absolute  time  of  day  when  this  task  will  be 
format  is  hh:mm:ss,  where: 


initiated 


Input 


hh  -  Hours  (decimal  assumed) 
mm  -  Minutes  (decimal  assumed) 
ss  -  Seconds  (decimal  assumed) 

/keyword  ( s) 

One  or  both  of  the  following  keywords: 

/RSI=magu 
/UIC= [uic] 

These  keywords  are  described  under  Format  1. 


Examples 

VMR>RUN  XKE  15M 

Runs  task  XKE  15  minutes  from  the  current  system  image  time. 
VMR>RUN  XKE  15M/RSI=90S/UIC= [3/1] 

Runs  task  XKE  15  minutes  from  the  current  system  image  time, 
rescheduling  it  every  90  seconds.  The  task  is  running  under  UIC 
[3/1]  • 


Note 


The  correct  value  to  be  inserted  in  the  clock  queue  for  Formats  2 
through  4  is  computed  from  the  current  value  of  the  system  time 
stored  in  the  system  image.  Thus,  the  system  image  time  must  be 
set  before  any  RUN  requests  are  made  or  they  may  not  occur  at  the 
correct  time  after  the  system  is  booted. 
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SAV 


SAVE 

Use  the  SAVE  command  to  write  the  image  of  a  system  onto  a  sequential 
medium  in  bootstrappable  format.  With  this  command,  you  can  copy  an 
RSX-11S  or  a  foreign  system  onto  a  tape  or  a  floppy  disk.  You  can 
then  transport  the  tape  or  floppy  to  another  computer  and  bootstrap 
it,  using  a  hardware  bootstrap.  (Refer  to  the  description  of  the  /IM 
switch  in  Section  10.2.) 

On  paper  tape,  system  images  are  created  in  absolute  loader  format  and 
must  be  bootstrapped  with  the  absolute  loader. 

Format 

SAV[E1  ddnn : [label) (/keyword ( s) ] 

Parameters 
ddnn : 


The  device  unit  onto  which  the  system  image  is  to  be  written. 
Valid  devices  are  as  follows: 

CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

DX:  RX01  flexible  disk 

DY:  RX02  flexible  disk 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

MS:  TS11  magnetic  tape 

MT:  TE/TU10/TS03  magnetic  tape 

PP:  Paper  tape 

label 

The  file  label  name  that  must  be  specified  for  all  secondary 
media  except  paper  tape.  it  consists  of  from  1  to  12 
alphanumeric  characters. 

Keywords : 

/B00T=type : 


Specifies  the  type  of  boot  block  being  used  when  the  system  image 
is  saved.  The  options  for  type  are  DX:  (for  RXOls)  and  DY: 
(for  RX02s) . 

The  keyword  allows  you  to  boot  on  an  RX01  a  system  that  was  saved 
on  an  RX02  in  single— densi ty  mode  and  vice  versa. 

If  you  do  not  use  /BOOT,  the  boot  block  for  the  type  of  device 
being  used  is  written  to  the  device. 

/DENS=1600 

Specifies  the  bits  per  inch  (bpi)  density  for  the  following 
9-track  magnetic  tapes:  TE16,  TU16,  TU45,  and  TU77.  These  tapes 
use  the  device  mnemonic  MM: 
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Example 


VMR>SAV  MT:MYSYS 


In  this  example ,  the  system 
bootstrappable  format.  System 
are  also  saved  with  the  system 


image  is  written  onto  MT:  in 

changes  made  by  other  VMR  commands 
image . 


Notes 


1.  When  you  save  RSX-11S  systems  on  paper  tape  and  you  do  not 
apply  the  /IM  switch  to  the  system's  file  name  (refer  to 
Section  10.2  for  a  description  of  the  /IM  switch) ,  the  last 
1000(8)  bytes  of  the  system  image  are  not  written  out.  This 
allows  space  to  accommodate  the  absolute  loader.  When  you 
specify  the  /IM  switch  with  the  system's  file  name,  the 
entire  system  image  is  written  to  paper  tape.  In  this  case, 
it  is  your  responsibility  to  ensure  that  the  system  image  is 
not  so  large  that  it  overlays  the  absolute  loader. 

2.  When  you  save  a  system  on  paper  tape,  contiguous  blocks  that 
contain  only  zero  and  that  begin  on  a  32-word  address  are 
compressed  into  a  2-word  descriptor.  This  compression 
significantly  reduces  both  the  amount  of  paper  tape  required 
and  the  time  expended  to  create  the  tape  and  to  read  it  into 
memory.  After  the  entire  image  has  been  loaded  into  memory, 
a  short  routine  zeroes  the  appropriate  blocks  of  memory 
before  passing  control  to  the  bootstrapped  system. 

3.  When  you  bootstrap  systems  on  media  other  than  paper  tape, 
regardless  of  the  size  of  the  system  image,  the  last  1000(8) 
bytes  of  physical  memory  are  not  copied  to  accommodate  the 
bootstrap. 

4.  Systems  saved  on  a  TE/TU10/TS03  9-track  magnetic  tape  drive 
can  be  booted  from  a  TE/TUlfS  drive  and  vice  versa. 


5#  When  you  specify  the  /IM  switch  with  the  system  file 
specification,  the  SAVE  command  always  uses  a  bootstrap  that 
does  not  enable  memory  management. 


6. 


On  RSX-11M,  the  maximum  memory  size  of  a  system  is  124K 
words.  The  SAVE  command  imposes  maximum  sizes  on  saved 
images  of  mapped  systems  for  certain  devices.  If  a  ,  mapped 
system  is  saved  and  its  memory  size  is  greater  than  the 
maximum  size  imposed  by  the  SAVE  command  for  the  specified 
device,  only  the  amount  of  memory  equal  to  the  maximum  size 
(starting  at  physical  location  0)  is  saved;  no  diagnostic 
message  is  issued. 

The  devices  for  which  the  SAVE  command  imposes  a  maximum  size 
on  saved  system  images  are: 


paper  tape  punch  (PP:) 
Cassette  tape  (CT:) 

RX01  flexible  disk  (DX:) 


28K  words 
28K  words 
1 23K  words 


RX02  flexible  disk  (DY:) 


1 23K  words 
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7.  None  of  the  bootstraps  require  that  a  target  RSX-11S  system 
have  a  driver  for  the  bootstrap  device. 

8.  Unless  you  specify  /DENS=1600,  when  you  save  a  system  image 
to  a  magnetic  tape  drive  that  supports  multiple  densities, 
the  drive  is  forced  to  800  bpi  before  the  SAVE  operation  is 
started . 
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SET 

Use  the  SET  command  to  alter  a  number  of  system-wide  characteristics. 
The  following  list  describes  the  available  options.  The  SET  command 
allows  you  to: 

•  Display  the  status  (determined  by  the  keyword  specified)  for 
all  terminals 

•  Establish  device  characteristics  for  any  device  in  the  system 

•  Establish  the  default  UIC  for  any  terminal  in  the  system 

•  Establish  the  system  UIC  used  by  the  LOAD  command  and  the 
install-run-remove  option  of  the  RUN  command 

•  Set  the  status  of  any  terminal  in  the  system 

•  Create  and  eliminate  partitions 

•  Add  space  to  the  system  dynamic  memory 

•  Enable  write  checking  and  seek  optimization  on  devices  that 
support  it 

Improper  use  of  the  SET  command  can  result  in  a  situation  in  which  the 
system  will  not  accept  privileged  user  input.  The  following 
situations  should  be  avoided: 

•  The  system  does  not  have  any  nonslaved,  privileged  terminals. 
This  is  unacceptable  because  nonpr iv ileged  terminals  cannot 
enter  privileged  commands  and  slaved  terminals  cannot  enter 
unsolicited  input  to  MCR.  See  the  description  of  the  /SLAVE 
keyword . 

•  The  buffer  length  of  any  nonslaved,  privileged  terminal  is 

shorter  than  14  bytes  on  RSX-11M  and  shorter  than  2  bytes  on 

RSX-1 1M-PLUS •  In  this  case,  the  terminal  buffer  is  too  small 

to  enter  many  important  commands  required  either  to  continue 
system  operation  or  alter  the  status  of  other  terminals.  See 
the  description  of  the  /BUF  keyword. 

On  RSX-1 1M ,  a  number  of  SET  command  options  (for  example,  /CRT, 

/ ESCSEQ,  /LOWER,  and  /WCHK)  require  Executive  features  that  must  be 
included  at  system  generation.  If  you  specify  an  option  that  has  not 
been  generated  into  the  system  image,  the  SET  command  has  no  effect 
and  results  in  an  error  message. 

Also,  some  of  the  keywords  are  only  supported  with  the  full-duplex 
terminal  driver.  The  full-duplex  terminal  driver  is  a  system 

generation  option  in  RSX-11M  systems  but  is  always  included  in 

RSX-1 1M-PLUS  systems.  Note  that  if  you  select  the  full-duplex  driver 
on  RSX-1 1M ,  you  must  also  select  the  get/set  multiple  characteristics 
options  to  set  or  display  any  terminal-related  characteristics. 

VMR  permits  only  one  keyword  per  command  line.  You  can  prefix  most 

keywords  by  NO  to  negate  or  disable  the  function  of  the  keyword.  VMR 

returns  a  syntax  error  message  when  NO  precedes  a  keyword  for  which  it 
is  illegal. 
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Examples  of  using  the  SET  command  follow  the  description  of  the 
keywords . 

Format 

SET  /keyword=val ue 
Parameter 
/keyword=value 

One  of  the  keywords  listed  in  Table  10-1.  The  keywords  are 
described  in  alphabetical  order  following  the  table. 

Table  10-1 
SET  Keywords 


Type 

Keywords 

Device 

Characteristics 

/ABAUD [  =  ttnn :  ] 

/BRO [=ttnn : ] 

/BUF=ddnn: [size] 

/ CRT [=ttnn : ] 

/EBC [=ttnn : ] 

/ ECHO [=ttnn : ] 

/ESCSEQ(=ttnn:] 

/FDX [=ttnn : ] 

/FORMFEED[=ttnn : ] 

/HFILL=ttnn : [value] 

/HHT [=ttnn : ] 

/LINES=ddnn: [value] 

/LOWER [=ttnn:] 

/OPT [=ddnn  sopttyp] 

/PRIV[=ttnn : ] 

/PUB [=ddnn : ] 

/REMOTE [=ttnn: [baud] ] 

/RPA [=ttnn : ] 

/SLAVE [=ttnn:] 

/SPEED=ttnn: [recv:xmit] 

(continued  on  next  page) 
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Table  10-1  (Cont.) 

SET  Keywords 

Type 

Keywords 

Device 

Characteristics 

(Cont.) 

/TERM=ttnn : [typel 

/TYPEAHEAD [=ttnn : [size] ] 

/UIC[=[uic] [:ttnn:]] 

/VFILL= [ ttnn : ] 

/WCHK [=ddnn : ] 

/WRAP[=ttnn : ] 

Enable/Disable 

Log  in 

/LOGON 

Library  or 

System  UICs 

/LIBUIC [= [uic] ] 

/NETUIC [= [uic] ] 

/ SYSUIC [= [uic] ] 

Memory 

Allocation 
(see  notes 
before 
examples) 

/AFF= [UNIBUS-mask] 

/BOT=pname  rvalue 

/MAIN=pname [ rbase :si ze : type] 

/NOMAIN=pname 

/MAXEXT [=si ze] 

/PAR=pname [ rbase : si ze [ : type] ] 

/NOPAR=pname 

/POOL  [  =  top] 

/POOLS IZ  E [=val ue] 

/ SECPOL 

/SUB=mname  rpname [ rbase  r si ze] 

/NOSUB=mname  rpname 

/TOP=pname  r val ue 

Pool 

Monitor  Task 

/PLCTL [=  [high]  [ :  [low]  [ :  [frsiz]  [  :basep]  ]  ]  ] 

System 

Tuning 

/RNDC [=nn] 

/RNDH [=nn] 

/RNDL  [  =  nn] 

/SWPC  [=nn] 

/SWPR [=nn] 
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Keywords : 

/ABAUD [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  autobaud  detection 
for  the  remote  dial-up  line  for  the  specified  terminal.  The 
terminal  driver  samples  the  line's  first  input  character,  tries 
to  determine  the  incoming  baud  rate,  and  sets  the  interface  speed 
accord ingly . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  with  autobaud  detection. 

/NOABAUD [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  autobaud  detection 
for  the  specified  terminal.  The  terminal  driver  does  not  attempt 
to  determine  the  incoming  baud  rate  for  the  remote  dial-up  line. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  autobaud  detection. 

/AFF= [UNIBUS-run-mask , . . . 1 

(RSX-1 1M-PLUS  multiprocessor  systems  only.)  Specifies  which  I/O 
page  will  contain  the  device  partition.  The  keyword  is  required 
for  creating  device  partitions  on  the  system. 

UNIBUS-run-mask 

A  3-letter  name  of  the  UNIBUS  Run  Mask  (URM)  with  which  the 
device  partition  is  associated.  There  is  one  URM  for  each 
processor,  as  follows: 

CPA 

CPB 

CPC 

CPD 

There  are  also  up  to  12  URMs  for  the  switched  UNIBUS  runs, 
as  follows: 


UBE 

UBK 

UBP 

UBF 

UBL 

UBR 

UBH 

UBM 

UBS 

UBJ 

UBN 

UBT 

You  must  specify  at  least  one  URM.  If  you  specify  more  than  one 
URM,  you  must  separate  them  by  commas. 

You  must  enclose  the  URM  specification  in  brackets. 

For  example,  to  create  a  device  partition  that  is  mapped  to  CPA's 
I/O  page,  enter  the  following  command: 

SET  /PAR=DEVP: 177600 : 200 : DEV/AFF= [CPA] 
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/BOT=pname  rvalue 

Directs  VMR  to  move  the  bottom  boundary  of  the  specified 
system-controlled  partition  up  or  down  the  amount  indicated  by 
the  value  parameter.  The  keyword  modifies  the  bottom  boundary  of 
a  partition  even  though  it  has  tasks  installed  in  it.  If  you 
modify  the  partition  so  that  it  becomes  too  small  to  hold  the 
tasks  installed  in  it,  VMR  displays  a  warning  message;  but  it 
will  modify  the  partition  anyway. 

pname 


The  1-  to  6-character  alphanumeric  partition  name. 

value 

The  number  of  64-byte  blocks. 

The  value  parameter  can  be  supplied  in  five  formats: 
+value,  -value,  value,  +*  or  * ,  and 

+value 

Moves  the  bottom  boundary  up  by  the  specified  amount. 
Moving  the  bottom  boundary  up  makes  the  partition 
smaller . 


NOTE 

You  can  supply  the  value  in  the  same  units  as 
those  of  the  base  and  size  parameters  for  the 
/PAR  keyword. 


-value 

Moves  the  bottom  boundary  down  by  the  specified  amount. 
Moving  the  bottom  boundary  down  makes  the  partition 
larger . 


value 


Establishes  the  total  partition  size  equal  to  the 
specified  value  by  moving  the  bottom  boundary. 

+*  or  * 

Moves  the  bottom  boundary  up  as  far  as  possible.  Note 
that  using  this  format  will  cause  the  bottom  boundary 
to  move  up  to  the  bottom  of  the  first  fixed  task  or 
fixed  driver  loaded  into  the  partition  at  the  time  the 
/BOT  keyword  is  executed.  If  there  is  nothing  loaded 
into  the  partition,  it  assumes  a  size  of  one  64-byte 
block . 


_* 


Moves  the  bottom  boundary  down  as  far  as  possible. 
Using  this  format  will  cause  the  bottom  boundary  of  the 
partition  to  move  down  to  the  top  boundary  of  the 
partition  below  it,  or  to  the  top  of  the  Executive  pool 
if  the  partition  is  the  lowest  partition  in  memory. 
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/BRO [=ttnn : ] 


Enables  the  broadcast  option  for  the  specified  terminal.  The 
terminal  can  receive  messages  sent  from  other  terminals  with  the 
MCR  BROADCAST  command . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  can  receive  messages. 

The  /BRO  keyword  is  valid  only  on  systems  with  multi-CLI  support. 
/NOBRO [=ttnn : ] 

Disables  the  broadcast  option  for  the  specified  terminal.  The 
terminal  cannot  receive  messages  sent  from  other  terminals. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  cannot  receive  messages. 

The  /NOBRO  keyword  is  valid  only  on  systems  with  multi-CLI 
support. 

/BUF=ddnn: [size] 

Sets  the  default  buffer  size  of  the  specified  device.  The  size 
must  be  greater  than  zero  and  less  than  or  equal  to  255(10)  (for 
a  terminal,  the  buffer  size  must  be  greater  than  or  equal  to  15 
decimal)  .  The  /BUF  keyword  is  particularly  useful  for  defining 
line  printer  width  (80  or  132  columns) . 

When  you  omit  the  size  specification,  VMR  displays  the  current 
buffer  size  of  the  device. 


/CRT(=ttnn : ] 


Defines  the  specified  terminal  as  a  cathode  ray  tube  (CRT) 
terminal  and  enables  the  backwards  deletion  option.  When  the 
backwards  deletion  option  is  enabled,  pressing  the  RUBOUT  or 
DELETE  key  moves  the  printing  position  one  space  to  the  left  and 
erases  any  character  displayed  in  that  position. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  defined  as  CRTs. 

/NOCRT [  =  ttnn :  ] 


Deletes  the  CRT  status  of  the  specified  terminal  and  disables  the 
backwards  deletion  option. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  are  not  defined  as  CRTs. 

/EBC [=ttnn : ] 


(Full-duplex  terminal  driver  only.)  Enables  the  8-bit  character 
option.  The  terminal  driver  passes  all  eight  bits  of  the  input 
characters  to  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  8-bit  character  option  enabled. 
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/NOEBC [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  the  8-bit  character 
option.  The  terminal  driver  strips  off  the  parity  bits  of  the 
input  characters  before  passing  them  to  the  device. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  8-bit  character  option  enabled. 

/ECHO [=ttnn : ] 

Enables  the  echo  option.  The  terminal  driver  displays  each 
character  that  is  typed  on  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  echo  option  enabled. 

/NOECHO [=ttnn : ] 

Disables  the  echo  option.  The  terminal  driver  does  not  display 
the  characters  that  are  typed  on  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  echo  option  disabled. 

/ESCSEQ[=ttnn : ] 

Enables  the  recognition  of  escape  sequences  from  the  specified 
terminal.  The  terminal  driver  treats  the  ESC  character  as  the 
beginning  of  an  escape  sequence  rather  than  as  a  line  terminator. 
(See  the  RSX-11M/M-PLUS  I/O  Drivers  Reference  Manual  for  further 
information  about  escape  sequences.) 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  recognize  escape  sequences. 

/NOESCSEQ (=ttnn : ] 

Disables  the  recognition  of  escape  sequences  at  the  specified 
terminal . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  support  the  recognition  of  escape 
sequences . 

/FDX[=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  the  full-duplex 
option.  The  terminal  driver  accepts  input  from  the  specified 
terminal  while  simultaneously  outputting  to  it. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  full-duplex  option  enabled. 

/NOFDX [=ttnn :  ] 

(Full-duplex  terminal  driver  only.)  Disables  the  full-duplex 
option.  The  terminal  driver  will  not  process  input  and  output 
from  the  specified  terminal  simultaneously. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  full-duplex  option  enabled. 
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/FORMFEED [=ttnn:] 

Indicates  that  the  specified  terminal  has  a  hardware  form  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  hardware  form  feeds. 

/NOFORMFEED [=ttnn : ] 

Indicates  that  the  specified  terminal  will  not  have  a  hardware 
form  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  do  not  have  hardware  form  feeds. 

/HFILL=ttnn : [value] 


(Full-duplex  terminal  driver  only.)  Specifies  the  number  of  fill 
characters  (value)  that  the  terminal  driver  is  to  place  after  a 
carriage  return  when  outputting  to  the  specified  terminal.  The 
value  is  a  number  from  0  through  7. 

When  you  omit  the  value  parameter,  VMR  displays  the  number  of 
fill  characters  currently  being  output  by  the  terminal  driver  to 
the  specified  terminal. 

/HHT [=ttnn : ] 


(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  has  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  a  hardware  horizontal  tab. 

/NOHHT [=ttnn : ] 


(Full-duplex  terminal  driver  only.)  Indicates  that  the  specified 
terminal  will  not  have  a  hardware  horizontal  tab. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  a  hardware  horizontal  tab. 

/LIBUIC [= [ uic]  1 

(RSX-11M-PLUS  systems  only.)  Directs  the  INSTALL  command  to 
search  the  specified  UIC  in  response  to  a  RUN  $file  or  INS  $file 
command  when  the  file  is  not  in  the  system  UIC. 

The  UIC  is  in  the  format  [g,m],  where  g  and  m  are  octal  numbers 
from  1  through  377(8)  that  represent  a  group  and  member  number, 
respectively.  The  square  brackets  are  required  syntax.  The 
default  LIBUIC  is  [3,54]. 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
library  UIC. 
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/LINES=ddnn: [value] 

(Full-duplex  terminal  driver  only.)  Establishes  the  number  of 
lines  per  page  on  the  specified  device.  The  value  is  a  number 
from  1  through  255(10).  If  you  specify  a  number  that  is  larger 
than  the  number  of  lines  per  page  possible  for  a  given  device, 
VMR  defaults  to  the  largest  number  possible  for  that  device. 

When  you  omit  the  value  parameter,  VMR  displays  the  lines  per 
page  for  the  specified  device. 

/LOGON 

Enables  logging  in  on  terminals  in  a  multiuser  protection  system. 
(See  /NOLOGON  for  more  information.) 

/NOLOGON 

Disables  logging  in  on  terminals  in  a  multiuser  protection 
system.  /LOGON  and  /NOLOGON  clear  and  set  a  flag  checked  by  the 
HELLO  command  when  a  user  attempts  to  log  in  on  a  terminal. 
/NOLOGON  provides  a  means  of  preventing  users  from  accessing  the 
system  during  such  activities  as  system  maintenance  or  account 
file  maintenance. 

/LOWER [=ttnn:] 

Specifies  that  lowercase  characters  are  not  to  be  converted  to 
uppercase  when  they  are  received  from  the  specified  terminal. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  lowercase  characters  are  not  converted. 

/NOLOWER [=ttnn : ] 

Resets  the  terminal  characteristics  of  the  specified  terminal  so 
that  lowercase  characters  received  on  input  are  automatically 
converted  to  uppercase  and  echoed  as  uppercase. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  for  which  conversion  to  uppercase  is  specified. 

/MAIN=pname [ :base :si ze : type] 

(RSX-11M  systems  only.)  Establishes  a  main  partition. 

pname 

The  1-  to  5-character  alphanumeric  partition  name. 

base 

The  physical  base  address  of  the  partition  specified  as  a 
number  of  64-byte  blocks. 

size 

The  size  of  the  partition  specified  as  a  number  of  64-byte 
blocks.  The  maximum  size  is  0  to  1920. K  words  for  a  task, 
common,  or  main  partition. 
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type 

SYS  for  a  main  partition,  DEV  for  a  common  partition  that 
maps  the  device  registers,  COM  for  a  common  partition,  or 
TASK  for  a  task  partition. 

Main  partitions  are  allocated  for  user  tasks  and  loadable 
drivers . 

Device  partitions  are  allocated  for  device  commons  that  are  used 
by  tasks  to  access  the  device  registers  on  the  I/O  page. 

You  can  enter  base  and  size  in  any  of  the  following  formats: 

Format  Calculated  Value 


nnnn 
nnnn . 
nnnK 
nnn  ,K 


Octal  (nnnn*100) 

Dec imal  ( nnnn .*64 , ) 
Octal  K  (nnn*4000) 
Decimal  K  (nnn. *2048.) 


where  nnnn  is  a  number  to  which  a 
applied  to  determine  the  value  used. 


values  are: 

Octal 
Dec imal 
Octal  K 
Decimal  K 


0<=base<l 77777 
0 . <=base<65535 
0K<=base<3777K 
0 . K<=base<  2047 . K 


multiplication  factor  is 
Valid  ranges  of  calculated 


0<si ze<2000 
0 . <  si ze<l 024 . 
0K<si ze<40K 
0 . K<si ze<32 . K 


For  system-controlled  partitions,  size  may  range  from  0  to  1920. K 
or  any  valid  representation  of  these  limits. 

You  can  specify  the  base  address  of  a  partition  through  a 
wildcard  (*)  for  TASK  or  SYS  partitions  in  a  mapped  system.  When 
you  specify  a  wildcard  (*) ,  VMR  creates  a  partition  at  the  lowest 
address  possible  for  a  partition  of  the  size  you  have  specified. 

You  can  also  specify  the  size  of  a  partition  through  a  wildcard 
(*)  for  SYS  partitions.  When  you  specify  the  wildcard  (*) ,  VMR 
creates  the  largest  possible  partition  starting  at  the  base 
address  you  have  specified  in  the  base  parameter. 

When  you  specify  wildcards  for  both  the  base  and  size,  VMR  will 
create  a  partition  that  will  completely  fill  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  task-controlled  partition,  VMR  also  displays 
the  parameters  of  all  its  subpartitions. 


/NOMAIN=pname 


Eliminates  a  named  main  partition  from  the  system.  The  partition 
you  specify  is  eliminated  from  the  list  of  partitions  and  the 
system.  If  any  tasks  or  commons  are  installed  in  or  attached  to 
the  partition,  the  partition  is  not  eliminated  and  VMR  generates 
an  error  message. 
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/MAXEXT [=si ze] 

Establishes  the  maximum  size  to  which  a  task  can  extend  itself 
beyond  its  mapped  array  area  by  means  of  the  EXTEND  TASK 
directive.  (See  the  RSX-11M/M-PLUS  Executive  Reference  Manual 
for  a  description  of  the  directive.)  The  size  is  given  in  units 
of  32(10)-word  blocks.  The  maximum  size  allowed  is  1777(8)  for 
systems  without  PLAS  and  177777(8)  for  systems  with  PLAS. 


You  can  specify  size  in  the  following  five  formats: 


Specified 

Size 


Resulting 

Size 


n  (n*100)  octal 

n.  (n*64.)  decimal 

nK  (n*4000)  octal 

n.K  (n*2048 . )  decimal 

*  1777(8)  maximum  for  systems  without  PLAS; 

177777(8)  maximum  for  systems  with  PLAS 


When  you  omit  the  size  specification,  VMR  displays  the  current 
maximum  extension  size  in  100(8)-byte  units. 


The  /MAXEXT  keyword  is  valid  only  on  mapped  RSX-11M  systems  that 
have  selected  the  EXTEND  TASK  directive  option  during  system 
generation  and  on  all  RSX-11M-PLUS  systems.  However,  you  can  use 
both  the  unmapped  and  mapped  versions  of  VMR  to  establish  the 
maximum  extension  size  for  tasks. 

/NETUIC [= [ ui c] ] 

Specifies  the  UIC  in  which  all  DECnet-related  tasks  are  stored. 
The  keyword  applies  only  to  systems  that  selected  the  external 
communication  products  option  during  system  generation.  The  UIC 
is  in  the  format  [g,m],  where  g  and  m  are  octal  numbers  from  1  to 
377(8)  that  represent  a  group  and  member  number,  respectively. 
The  square  brackets  are  required  syntax. 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
network  UIC. 

/OPT  [=ddnn  :opttypl 

(RSX-11M-PLUS  systems  only.)  Enables  disk  I/O  queue  optimization 
for  the  specified  device.  For  more  information  on  optimization 
and  on  the  algorithm  (opttyp)  parameter  for  this  keyword,  see 
Chapter  16. 

ddnn : 

The  device  that  will  use  I/O  queue  optimization.  Legal 
devices  are  DB:-,  DL : - ,  DM:-,  and  DR:-type  devices.  When 
you  do  not  specify  a  device,  VMR  displays  all  the  devices 
that  use  optimization. 
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opttyp 

The  algorithm  for  optimization.  The  algorithms  are: 

NEAR [ EST] 

ELEVfATOR] 

CSCAN 

The  default  algorithm  set  at  system  generation  is  NEAR. 
/NOOPT [=ddnn :  ] 

(RSX-11M-PLUS  systems  only.)  Disables  disk  I/O  queue  optimization 
for  the  specified  device. 

When  you  omit  the  device  specification,  VMR  displays  all  the 
devices  that  do  not  use  I/O  queue  optimization. 

/PAR=pname [ :base :si ze [ : type] ] 

(RSX-1 1M-PLUS  systems  only.)  Establishes  a  partition. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 

base 

The  physical  base  address  of  the  partition  specified  as  a 
number  of  64-byte  blocks  or  as  a  wildcard  (*) . 

si  ze 

The  size  of  the  partition  specified  as  a  number  of  64-byte 
blocks  or  as  a  wildcard  (*) .  The  maximum  size  is  0  to 
1920.K  words  for  a  task,  common,  or  main  partition. 

type 

SYS  for  a  main  partition,  SECPOL  for  a  secondary  pool 
partition,  DEV  for  a  common  partition  that  maps  the  device 
registers,  or  CPU  for  CPU  partitions. 

Main  partitions  are  allocated  for  user  tasks  and  loadable 
drivers. 

Pool  partitions  are  allocated  for  secondary  pool. 

Device  partitions  are  allocated  for  device  commons  that  tasks  use 
to  access  the  device  registers  on  the  I/O  page.  Note  that 
creating  a  device  partition  automatically  creates  a  main 
partition  named  10  PAR,  which  spans  the  entire  I/O  page.  The 
partition. you  specify  with  the  /PAR  keyword  then  becomes  a 
subpartition  of  10  PAR.  On  multiprocessor  systems,  you  must  use 
the  /AFF  (affinity)  keyword  to  specify  which  I/O  page  contains 
the  device  partition. 

CPU  partitions  are  allocated  on  multiprocessor  systems  to  store 
vectors  for  all  the  devices  associated  with  the  particular 
processor . 

Partition  type  is  an  optional  parameter.  If  you  do  not  specify 
it,  SYS  is  the  default. 
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You  can  enter  base  and  size  in  any  of  the  following  formats: 


Format 


Calculated  Value 


nnnn 
nnnn  . 
nnnK 
nnn.K 


Octal  (nnnn*100) 

Dec  imal  (nnnn .*64 . ) 
Octal  K  (nnn*4000) 
Decimal  K  (nnn.*2048.) 


where  nnnn  is  a  number  to  which  a  multiplication  factor  is 
applied  to  determine  the  value  used. 

For  SYS  partitions,  size  can  range  from  0  to  1920. K  or  any  valid 
representation  of  these  limits.  For  example,  the  following 
inputs  for  size  allocate  a  2048 (10) -byte  partition: 


40 

32. 

IK 

l.K 


You  can  also  specify  the  base  address  of  a  partition  with  a 
wildcard  (*) ♦  When  you  specify  a  wildcard  (*) ,  VMR  creates  a 
partition  at  the  lowest  address  possible  for  a  partition  of  the 
size  you  have  specified. 

You  can  also  specify  the  size  of  a  partition  with  a  wildcard  (*) . 
When  you  specify  the  wildcard  (*) ,  VMR  creates  the  largest 
possible  partition  starting  at  the  base  address  you  have 
specified  in  the  base  parameter.  When  you  specify  a  wildcard  for 
a  CPU  partition,  VMR  creates  a  partition  of  size  (n-l)*4K,  where 
n  is  the  number  of  processors  specified  during  SYSGEN. 

When  you  specify  wildcards  for  both  the  base  and  size,  VMR 
creates  a  partition  that  completely  fills  the  first  gap  in  the 
existing  partition  layout. 

If  you  do  not  specify  base,  size,  or  type,  VMR  displays  the 
values  of  these  parameters  for  the  named  partition.  If  the  named 
partition  is  a  main  partition,  VMR  also  displays  the  parameters 
of  all  its  subpartitions. 

When  you  are  establishing  base  and  size  for  a  CPU  partition,  note 
that  the  entire  CPU  partition  must  exist  below  124K. 

/NOPAR=pname 

( RSX-1 1M-PLUS  systems  only.)  Eliminates  a  named  partition  from 
the  system.  The  partition  you  specify  is  eliminated  from  the 
list  of  partitions  and  the  system.  If  any  tasks  or  commons  are 
installed  in  or  attached  to  the  partition,  the  partition  is  not 
eliminated  and  VMR  generates  an  error  message. 

/PLCTL [=high]  [ :  [low]  [ :  [frsiz]  [  :basep]  ]  ]  ] 

(Systems  with  pool  monitoring  support  only.)  Sets  the  pool  limit 
parameters  used  by  the  Pool  Monitor  Task  ( PMT) .  The  following 
list  defines  the  parameters: 


high 


The  high  pool  limit  in  bytes 
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low 


The  low  pool  limit  in  bytes. 

f  rsi  z 


The  minimum  byte  size  of  the  largest  free  pool  block 
required  for  avoiding  low  pool  actions  by  the  Pool  Monitor 
Task  ( PMT.  .  . 


basep 


The  base  task  priority,  which  is  the  lowest  priority  a 
nonpr iv i 1  eg ed  task  can  have  and  still  be  eligible  for  memory 
contention  during  times  of  low  pool;  this  priority  remains 
in  effect  until  pool  conditions  improve.  (Note  that  only 
those  tasks  requested  to  run  while  the  system  is  in  a  low 
pool  state  are  affected) . 

The  following  list  defines  the  limits  of  the  parameters: 

84.  <=low  <=high  <=total  size  of  system  pool 
84.  <=frsiz  <=high 
0.  <=basep  <=250. 

The  following  list  gives  the  defaults  for  the  parameters: 


high 

1600 

.  bytes 

low 

600. 

bytes 

f  r  si  z 

200. 

bytes 

basep 

51. 

See  the  RSX-1 1/M-PLUS  System  Management  Guide  for  information  on 
determining  the  values  for  the  parameters^ 

When  you  omit  the  parameter  specifications,  VMR  displays  the 
current  parameters  for  the  system. 

/POOL  [= topi 

Increases  the  size  of  the  dynamic  storage  region  (pool), 
top 


The  first  location  in  memory  used  for  partition  allocation. 
You  specify  top  in  units  of  64-byte  blocks,  in  octal  or 
decimal . 

When  you  do  not  specify  top,  VMR  displays  the  virtual 
address  of  the  top  of  the  Executive,  the  size  of  the  longest 
block  of  pool  space  in  words,  the  total  number  of  words  in 
the  pool,  and,  on  RSX-1 1M-PLUS ,  the  lowest  physical  address 
at  which  a  partition  can  start.  (You  can  use  the  address 
when  calculating  partition  layouts  for  systems  supporting 
kernel  data  space.  If  your  system  is  not  a  kernel  data 
space  system,  this  value  is  always  equal  to  the  virtual 
address  of  the  top  of  pool.)  The  display's  format  is: 

POOL=top:max :total [ :par] 
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where  top  is  given  in  units  of  64-byte  blocks,  max  and  total 
are  in  decimal  words,  and  par  is  the  lowest  physical  address 
(32-word  blocks) . 

You  can  also  specify  top  by  using  a  wildcard  (*) .  The 
wildcard  directs  VMR  to  supply  the  maximum  amount  of  pool 
possible.  Specify  the  wildcard  as  follows: 

/POOL=* 

If  you  request  more  pool  than  can  be  supplied,  VMR  prints  a 
warning  message  and  supplies  the  maximum  amount  of  pool 
possible . 

/POOLS IZ  E [=val ue] 

Specifies  a  total  amount  of  pool  rather  than  a  top  address. 

If  you  do  not  specify  a  value,  VMR  displays  the  virtual  address 
of  the  top  of  the  Executive,  the  size  of  the  longest  block  of 
pool  space  in  words,  the  total  number  of  words  in  the  pool,  and 
the  lowest  physical  address  at  which  a  partition  can  start 
(32-word  blocks). 

/PRIV[=ttnn : ] 

Sets  the  specified  terminal  to  privileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
privileged  terminals  in  the  system. 

/NOPRIV[=ttnn :  ] 

Sets  the  specified  terminal  to  nonpr ivileged  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
nonpr ivileged  terminals  in  the  system. 

/PUB  [=ddnn : ] 

Establishes  the  specified  device  as  a  public  device. 

When  you  omit  the  device  specification,  VMR  displays  all  the 

public  devices  in  the  system. 

/NOPUB [=ddnn : ] 

Causes  the  specified  device  to  lose  its  public  status. 

When  you  omit  the  device  specification,  VMR  displays  all  the 

nonpublic  devices  in  the  system. 

/REMOTE [=ttnn: [speed] ] 

Declares  that  the  specified  terminal  is  connected  to  a  modem  and 
can  be  connected  to  the  system  by  means  of  a  dial-up  network. 
The  terminal  has  a  line  to  a  DH11,  DL11,  or  DZ11  multiplexer. 

Specifying  speed  establishes  the  initial  baud  rate  (answer  speed) 
of  the  remote  dial-up  line  for  the  specified  terminal.  An  answer 
speed  is  allowed  only  for  DHlls  and  DZlls,  which  are  variable 
speed  multiplexers. 
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Valid  speeds  for  the  DH11  are  0,  110,  150,  200,  300,  600,  1200, 

1800,  2400,  4800,  and  9600. 

Valid  speeds  for  the  DZ11  are  110,  150,  300,  600,  1200,  1800, 

2000,  2400,  3600,  4800,  7200,  and  9600. 

Note  that  with  the  /REMOTE  keyword,  DHlls  and  DZlls  do  not 
support  split  speeds.  The  answer  speed  must  be  the  same  as  the 
speed  at  which  the  terminal  is  receiving  characters  from  the 
computer . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
remote  terminals. 

/NOREMOTE [=ttnn:] 

Establishes  the  terminal's  line  as  a  local  line  not  connected  to 
a  modem.  The  line  was  previously  to  a  DZ11  multiplexer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
local  terminals. 

/RNDC [=nn] 

(RSX-11M-PLUS  systems  only.)  Defines  the  length  of  the  Executive 
round-robin  scheduling  interval  in  ticks.  The  parameter  nn  can 
be  an  octal  value,  or  decimal  value  if  followed  by  a  period  (.). 
The  minimum  value  for  nn  is  0.  See  the  RSX-11M-PLUS  System 
Generation  and  Installation  Guide  for  more  information . 


When  you  omit  the  length  specification,  VMR  displays  the  current 
value  for  the  interval. 

/RNDH [=nn] 

(RSX-11M-PLUS  systems  only.)  Defines  the  highest  priority  (1 
through  250  decimal)  that  will  be  considered  for  Executive 
round-robin  scheduling.  The  priority  class  must  be  higher  than 
the  one  specified  with  the  /RNDL  keyword.  See  the  RSX-11M-PLUS 
System  Generation  and  Installation  Guide  for  more  information. 


When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/RNDL [=nn] 

(RSX-1 1M-PLUS  systems  only.)  Defines  the  lowest  priority  (1 
through  250  decimal)  that  will  be  considered  for  Executive 
round-robin  scheduling.  The  priority  class  must  be  lower  than 
the  one  specified  with  the  /RNDH  keyword.  See  the  RSX-11M-PLUS 
System  Generation  and  Installation  Guide  for  more  info rmation . 


When  you  omit  the  priority  class,  VMR  displays  the  current  value 
for  the  priority. 

/RPA [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  the  read-pass-all 
option.  The  terminal  driver  passes  all  characters  input  at  the 
keyboard  to  the  terminal's  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  read-pass-all  option 
enabled. 
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/NORPA [=ttnn : ] 

(Full-duplex  terminal  driver  only,)  Disables  the  read-pass-all 
option.  The  terminal  driver  does  not  pass  special  function 
characters  (for  example,  CTRL/C)  input  at  the  keyboard  to  the 


terminal’s  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays 
terminals  on  the  system  that  have  the  read-pass- 
disabled  . 

all  the 
all  option 

/ SECPOL 

(RSX-1 1-M-PLUS  systems 

only.)  Displays  secondary  pool  use  in  the 

system.  The  display  i: 

s  in  the  following  format: 

SECPOL=secf r :secsiz:pctfr 


secf  r 

The  number  of  free  blocks  in  secondary  pool  in  units  of 
32-word  (decimal)  blocks. 

secsi z 

The  size  of  secondary  pool  in  units  of  32-word  (decimal) 
blocks . 

pctf  r 

The  percentage  of  free  blocks  in  secondary  pool. 

/SLAVE [=ttnns] 

Establishes  the  specified  terminal  as  one  that  can  enter  data 
only  if  it  is  solicited  by  a  task.  Thus,  the  specified  terminal 
always  rejects  unsolicited  input  (other  than  CTRL/O,  CTRL/Q,  and 
CTRL/S)  . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  slaved. 

/NOSLAVE [=ttnn:] 

Sets  the  specified  terminal  to  nonslaved  status. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  currently  classified  as  nonslaved. 

/SPEED=ttnn : [ recv :xmit] 

Establishes  the  receive  and  transmit  baud  rate  for  terminals 
attached  to  the  system  through  a  DH11  or  DZ11  multiplexer.  The 
recv  argument  is  the  baud  rate  at  which  characters  are  input  to 
the  computer  from  the  terminal.  The  xmit  argument  is  the  baud 
rate  at  which  characters  are  output  to  the  terminal  from  the 
computer.  You  must  specify  both  arguments  when  setting  the 
speed.  If  you  do  not  specify  either,  VMR  will  display  the 
current  settings. 

Valid  baud  rates  for  the  DH11  are:  0,  110,  150,  200,  300,  600, 

1200,  1800,  2400,  4800,  9600,  EXTA  (user-specified  baud  rate  A), 

and  EXTB  (user-specified  baud  rate  B) . 
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Valid  baud  rates  for  the  DZ11  are: 
1800,  2000 ,  2400,  3600,  4800,  7200, 


110,  150, 

and  9600. 


300,  600,  1200, 


The  receive  and  transmit  baud  rates  for  the  DH11  and  DZ11  must  be 
the  same  because  these  multiplexers  do  not  support  split  speeds. 


/SUB=mname :sname [ :base :si ze] 

(RSX-11M  systems  only.)  Establishes  a  subpartition. 
Subpartitions  can  only  be  established  in  user-controlled  main 
partitions. 

mname 

The  1-  to  6-character  main  partition  name.  The  subpartition 
being  defined  becomes  a  subpartition  in  the  named  main 
partition . 


sname 

The  1-  to  6-character  subpartition  name.  The  subpartition 
being  defined  becomes  a  subpartition  of  the  main  partition 
specified  in  mname. 

base 

The  physical  base  address  of  the  subpartition,  specified  as 
a  number  of  64-byte  blocks. 

size 

The  size  of  the  subpartition,  specified  as  a  number  of 
64-byte  blocks. 

Base  and  size  may  be  entered  in  any  of  the  following  formats; 
nnnn  is  a  number  to  which  the  system  applies  a  multiplication 
factor  to  determine  the  value  used. 


Format 

n 

n . 
nK 
n.K 

Valid  ranges 

Octal 
Decimal 
Octal  K 
Decimal 


Calculated  Value 


Octal  (nnnn*100) 

Dec imal  ( nnnn .*64.) 
Octal  K  (nnn*4000) 
Decimal  K  (nnn.*2048.) 

for  calculated  values  are 

0<=base<l 0000 
0.<=base<4096. 
0K<=base<200K 
K  0.K<= base <2047. K 


0<si ze<2000 
0 . <  si ze< 1024 • 
0K<si ze<4  OK 
O.K<size<32.K 


Example : 


Any  of  the  following  inputs  for  size  will  allocate 
2048 (10) -byte  subpartition . 


40 

32. 

IK 

l.K 


If  base  and  size  are  omitted,  VMR  displays  the  current  values  for 
the  named  subpartition. 
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/NOSUB=mname :sname 

Eliminates  the  specified  subpartition  from  the  main  partition. 
/SWPC  ■■■■■■I 

(RSX— 1 1M-PLUS  systems  only.)  Defines  the  number  of  clock  ticks 
for  a  single  Executive  swapping  interval.  The  parameter  nn  is  in 
the  range  0  through  45r568  and  can  be  an  octal  value,  or  decimal 
if  followed  by  a  period  (.).  See  the  RSX-11M-PLUS  System 
Generation  and  Installation  Guide  for  more  info rmation . 


When  you  omit  clock  ticks  specification,  VMR  displays  the  current 
value  for  the  interval. 

/SWPR  [=nn] 

(RSX-1 1M-PLUS  systems  only.)  Defines  a  new  priority  range  for 
Executive  swapping.  The  parameter  nn  is  in  the  range  0  through 
250(10)  and  can  be  an  octal  value,  or  decimal  if  followed  by  a 
period  (  .)  . 

The  value  for  the  /SWPR  keyword  affects  the  installed  priority  of 
all  tasks.  Each  task  is  initiated  at  its  installed  priority  plus 
the  value  for  nn  (priority  +  nn) .  While  the  task  is  executing, 
its  priority  is  decremented  until  it  becomes  the  installed 
priority  minus  the  value  for  n  (priority  -  nn) .  When  the 
priority  reaches  this  lower  limit,  the  task  is  swapped  out  so 

that  another  task  with  a  higher  priority  can  execute.  The 
priority  for  the  new  task  changes  in  the  same  way.  See  the 

RSX-1 1M- PLUS  System  Generation  and  Installation  Guide  for  more 
information . 

When  you  omit  the  range  specification,  VMR  displays  the  current 
value  for  the  priority  range. 

/SYSUIC [= [ uic] ] 

Establishes  the  UIC  for  the  system  and  all  system  tasks.  The  UIC 
has  the  format  [g,m] ,  where  g  and  m  are  octal  numbers  that 
represent  a  group  and  member  number,  respectively.  On  most 
unmapped  systems,  the  system  UIC  is  [1,50];  on  most  mapped 

systems,  the  system  UIC  is  [1,54] •  These  UIC  values  are  the 

initial  defaults  on  virgin  systems. 

The  UIC  specified  with  the  /SYSUIC  keyword  also  becomes  the 
default  UIC  used  by  the  LOAD  command  and  the  install-run-remove 
option  of  the  MCR  RUN  command. 

When  you  omit  the  UIC  specification,  VMR  displays  the  current 
system  UIC. 
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/TERM=ttnn: [type] 

(Full-duplex  terminal  driver  only.)  Establishes  the  terminal  type 
of  the  specified  terminal.  When  VMR  sets  the  terminal  type ,  it 
automatically  sets  the  HFILL ,  VFILL,  CRT,  FORMFEED,  and  HHT 

The  standard  terminal  types 


VT105 

VT125 

VT131 

VT132 


VMR  does 
However , 


characteristics  for 

the  terminal . 

are 

as  follows 

: 

ASR33 

LA30S 

LAI  20 

VT55 

ASR35 

LA  3  4 

LA180S 

VT61 

KSR33 

LA  3  6 

VT05B 

VT100 

LA12 

LA38 

VT50 

VT101 

LA30P 

LAI  00 

VT52 

VT102 

If 

you  specify 

a  terminal  type 

that  is 

not 

set  any 

device 

characteristics 

VMR 

stores  the 

value 

you  have 

speci  f  ie< 

( UCB) . 


When  you  omit  the  type  parameter,  VMR  displays  the  terminal  type 
of  the  specified  terminal. 

VMR  also  accepts  an  alternate  form  of  the  command.  You  can 
specify  the  terminal  type  and  equate  it  to  the  desired  terminal. 
This  automatically  associates  certain  characteristics  of  the 
particular  terminal  type  with  the  specified  terminal.  (See  the 
RSX- 11 M/M- PLUS  I/O  Drivers  Reference  Manual  for  a  list  of  the 
implicit  characteristics  for  each  terminal  type.)  The  command  is 
in  the  format: 


SET  /term-type=TTnn : 

where  term-type  is  one  of  the  standard  terminal  types, 
the  terminal  types  are  mutually  exclusive. 


Note  that 


The  half-duplex  terminal  driver  also  accepts  the  /term-type  form 
of  the  command.  However,  the  only  legal  terminal  types  for  the 
half-duplex  driver  are  / ASR33 ,  /LA30S ,  and  /VT05B .  The  command 
associates  implicit  characteristics  of  the  terminal  type  with  the 
specified  terminal,  but,  unlike  the  full-duplex  terminal  driver, 
the  types  are  not  mutually  exclusive. 

The  following  list  describes  the  effects  of  the  keywords  for  the 
half-duplex  terminal  driver: 


/ ASR33 
/LA30S 

/VT05B 


Converts  lowercase  letters  to  uppercase 
they  are  output  to  the  terminal. 


before 


Indicates  that  fill  characters  are  used  after  a 
carriage  return.  The  number  of  fill  characters 
used  depends  on  the  current  carriage  position  at 
the  time  the  carriage  return  occurs. 

Sets  a  vertical  file  of  three  nulls  after  a  line 
feed  on  60  Hz  systems  and  of  four  nulls  on  50  Hz 
systems . 
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/TOP=pname  rvalue 

Directs  VMR  to  move  the  top  boundary  of  the  specified  partition 
up  or  down  the  amount  indicated  by  the  value  parameter.  The 
keyword  modifies  the  top  boundary  of  a  system-controlled 
partition  even  if  the  partition  has  tasks  installed  in  it.  If 
you  modify  the  partition  so  that  it  becomes  too  small  to  hold  the 
tasks  installed  in  it,  VMR  displays  a  warning  message  but 
modifies  the  partition  anyway. 

pname 

The  1-  to  6-character  alphanumeric  partition  name. 


value 

The  number  of  64-byte  blocks. 

The  value  parameter  can  be  supplied  in  five  formats: 
+value,  -value,  value,  +*  or  *,  and  -*. 

+val ue 

Moves  the  top  boundary  up  by  the  specified  amount.  Moving 
the  top  boundary  up  makes  the  partition  larger. 

NOTE 

You  can  supply  the  value  in  the  same  units  as  the 
base  and  size  parameters  for  the  /PAR  keyword. 

-value 

Moves  the  top  boundary  down  by  the  specified  amount.  Moving 
the  top  boundary  down  makes  the  partition  smaller. 


value 


Establishes  the  total  partition  size  equal  to  the  specified 
value  by  moving  the  top  boundary. 

+*  or  * 

Moves  the  top  boundary  up  as  far  as  possible.  This  format 
causes  the  top  boundary  to  move  to  the  bottom  boundary  of 
the  partition  above  it  or  to  the  top  of  memory  if  the 
partition  is  the  top  partition  in  memory. 


Moves  the  top  boundary  down  as  far  as  possible.  This  format 
causes  the  top  boundary  to  move  down  to  the  top  of  the  first 
fixed  task,  common,  or  driver  in  the  partition  at  the  time 
the  /TOP  keyword  is  executed.  If  nothing  is  loaded  into  the 
partition,  the  partition  assumes  a  size  of  one  64-byte 
block . 
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/TYPEAHEAD [=ttnn : [size] ] 

(Full-duplex  terminal  driver  only.)  Enables  the  typeahead  option 
for  the  specified  terminal.  The  terminal  driver  stores  input 
characters  in  a  buffer  before  passing  them  to  a  requesting 
attached  task.  Thus,  characters  input  during  periods  between 
requests  are  not  lost. 

If  size  is  specified  (RSX-11M-PLUS  systems  that  support  kernel 
data  space  only) ,  the  typeahead  buffer  size  is  set  accordingly. 
The  value  for  sizecan  be  from  0  through  255(10).  If  you  specify 
0  or  1,  the  terminal  will  not  have  the  typeahead  option  enabled 
(same  effect  as  /NOTYPEAHEAD) .  The  default  for  size  is  86(10). 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  have  the  typeahead  option  enabled. 

/NOTYPEAHEAD [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  the  typeahead  option 
for  the  specified  terminal.  The  terminal  driver  does  not  store 
characters  to  prevent  their  loss  because  the  size  of  the  buffer 
is  forced  to  1. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  that  do  not  have  the  typeahead  option  enabled. 

/UIC[=[uic] :ttnn:] 

Establishes  the  specified  UIC  as  the  default  UIC  for  the 
specified  terminal  (the  default  is  TI:).  All  tasks  run  from  the 
terminal  are  run  with  the  UIC  of  the  terminal,  except  in  a 
multiuser  protection  system.  In  such  a  system,  a  privileged  user 
can  override  the  terminal  UIC  with  the  /UIC  keyword  of  the  RUN 
command.  Furthermore,  external  MCR  function  tasks  are  requested 
with  this  UIC.  These  tasks  are  the  MOUNT,  INSTALL,  DM0,  and  UFD 
commands  (which  run  as  tasks),  and  all  system-supplied  software. 

When  you  specify  only  the  terminal,  VMR  displays  the  UIC  for  that 
terminal . 

/VFILL [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Enables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
driver  adds  four  fill  characters  following  each  line  feed. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  VFILL  option  enabled. 

/NOVFILL [=ttnn : ] 

(Full-duplex  terminal  driver  only.)  Disables  the  vertical  fill 
characters  option  for  the  specified  terminal.  The  terminal 
driver  does  not  add  any  vertical  fill  characters  following  line 
feeds . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  do  not  have  the  VFILL  option 
enabled . 
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/WCHK [=ddnn : ] 

Specifies  for  all  Files-11  devices,  except  DX: ,  DY:,  and  magnetic 
tapes,  that  all  write  operations  are  to  be  followed  by  a  write 
check.  The  checks  assure  the  reliability  of  data  transfers  to 
the  specified  disk. 

On  RSX-11M,  Executive  support  for  write  checking  is  a  system 
generation  option  and  must  be  selected  for  this  command  to  have 
any  effect.  On  RSX-11M-PLUS ,  support  for  write  checking  is 
always  included. 

When  you  omit  the  device  specification,  VMR  displays  all  Files-11 
disk  drives  with  write  checking  enabled. 

/NOWCHK [=ddnn : ] 

Specifies  that  write  checking  is  to  be  disabled  for  the  specified 
device . 

When  you  omit  the  device  specification,  VMR  displays  all  disks 
that  support  write  checking,  but  have  the  option  disabled. 

/WRAP [  =  ttnn :  ] 

(Full-duplex  terminal  driver  only.)  Enables  the  wrap-around 
option  for  the  specified  terminal.  The  terminal  driver 
automatically  generates  a  carriage  return/line  feed  sequence  when 
the  number  of  input  characters  exceeds  the  buffer  size  of  the 
specified  terminal.  Both  the  carriage  return  and  line  feed  are 
transparent  and  do  not  appear  in  the  input  buffer. 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wrap-around  option  enabled. 

/NOWRAP [  =  ttnn :  ] 

(Full-duplex  terminal  driver  only.)  Disables  the  wrap-around 
option  for  the  specified  terminal.  The  terminal  driver  does  not 
accept  input  characters  beyond  the  input  buffer  size  for  the 
terminal . 

When  you  omit  the  terminal  specification,  VMR  displays  all  the 
terminals  on  the  system  that  have  the  wrap-around  option 
disabled . 

Notes  on  Memory  Allocation  Keywords 

1.  If  a  command  attempts  to  eliminate  a  partition  in  which  tasks 
are  installed  or  drivers  loaded,  VMR  rejects  the  command 
until  the  tasks  have  been  removed. 

2.  When  you  define  a  partition,  the  name  must  not  already  be 
defined  as  a  partition.  In  addition,  a  partition  cannot 
overlap  any  other  partition. 

On  RSX-11M,  subpartitions  can  overlap  other  subpartitions. 

3.  The  address  specified  with  the  /POOL  keyword  must  be  lower 
than  the  base  address  of  the  first  partition  in  the  system. 

On  RSX-11M,  an  exception  is  the  partition  LDRPAR  for  a 
resident  loader.  LDRPAR  is  in  the  Executive. 
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4.  Once  you  have  allocated  space  to  the  dynamic  storage  region 
(pool) ,  you  cannot  recover  the  space  for  use  in  partitions. 

5.  When  the  highest  memory  addresses  of  a  system  are  allocated, 
the  size  of  the  partition  is  modified  automatically  to 
reflect  the  amount  of  memory  present  when  the  system  is 
bootstrapped . 

6.  On  RSX— 11M-PLUS,  SET  /TOP  and  SET  /BOT  work  correctly  for 
secondary  pool  partitions. 

7.  If  the  last  partition  is  system-controlled,  its  top  address 
is  modified  by  the  SAVE  command  at  boot  time  to  reflect  the 
actual  top  of  physical  memory  of  the  hardware  in  use. 


Examples 

VMR> SET  /ABAUD=TT4 : 

Enables  the  autobaud  detection  option  for  TT4:. 

VMR>SET  /ABAUD 
ABAUD=TT2 : 

ABAUD=TT4: 

ABAUD=TT5 : 

Displays  all  the  terminals  that  have  the  autobaud  detection 
option  enabled. 

VMR> SET  /BR0=TT5: 

Enables  the  broadcast  option  for  TT5:. 

VMR>  SET  /BRO 
BR0=TT2 : 

BR0=TT4 : 

BR0=TT5: 

Displays  all  the  terminals  that  have  the  broadcast  option 
enabled. 

VMR>  SET  /BUF=LP0: 

BUF=LP0 : 132 . 

Displays  the  current  buffer  size  of  LPO:. 

VMR>  SET  /BUF=TT1 : 40 . 

Sets  the  buffer  size  of  TT1 :  to  40(10). 

VMR>  SET  / CRT=TT3 : 

Enables  the  backwards  deletion  option  on  the  display  terminal 
whose  number  is  TT3:. 

VMR>  SET  /CRT 
CRT=TT3 : 

CRT=TT7 : 

CRT=TT12  s 

Displays  all  the  terminals  that  have  the  backwards  deletion 
option  enabled. 
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C 

O 

c 


VMR>  SET  / ESCSEQ=TT3 : 

Establishes  terminal  TT3 2  as  a  terminal  that  can  send  and 

receive  escape  sequences. 

VMR> SET  / ESCSEQ 
ESCSEQ=TT3 : 

ESCSEQ=TT7: 

ESCSEQ=TT16 : 

Displays  all  the  terminals  that  can  send  and  receive  escape 
sequences . 

VMR> SET  /NOESCSEQ=TT3: 

Disables  support  of  escape  sequences  for  TT3 : • 

VMR> SET  /LA30S=TT2 : 

VMR>  SET  /LA30S 
LA30S=TT0 : 

LA30S=TT2 : 

Sets  TT2 :  as  an  LA30S,  then  displays  all  LA30S  terminals. 

VMR> SET  /NETUIC 
NETUIC=[20,3] 

Displays  the  current  network  UIC. 

VMR>  SET  /NETUIC=[25,6] 


Sets  the  network  UIC  to  [25,6]. 


VMR>  SET  /OPT 

,=DM1 :  NEAR 

Enables  I/O 
algorithm . 

'  queue  optimization 

for 

DM1:  , 

using 

the  NEAR 

VMR> SET  /OPI 
OPT=DB0 : NEAR 
0PT=DB1 : NEAR 
OPT=DM0 : NEAR 
0PT=DM1 : NEAR 

\ 

Displays  all 
enabled . 

the  disk  devices  that 

have 

I/O 

queue 

optimi zation 

VMR> SET  / PLCTL 

PLCTL=1 600 . : 600 . :200. :51. 


Displays  the  current  pool 
Monitor  Task. 


limit  parameters  used  by  the 


Pool 


VMR>  SET  /PRIV=TT0 : 

Sets  TTO :  to  be  a  privileged  terminal. 

VMR> SET  / PRI V 
PRIV=TT0 : 

PRIV=TT1 : 

Displays  all  privileged  terminals. 
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VMR>SET  /REMOTE=TT21 : 

Sets  the  terminal  line  corresponding  to  TT21:  as  a  remote 

dial-in  line. 

VMR>SET  /REMOTE 
REM0TE=TT1 : 

REM0TE=TT2 : 

REM0TE=TT3 : 

REM0TE=TT4 : 

REM0TE=TT21 : 

Displays  all  the  terminals  that  are  currently  set  as  remote 
dial-in  lines. 

VMR>SET  /RNDC 
RNDC=6 . 

Displays  the  current  length  of  the  round-robin  scheduling 
interval . 

VMR>SET  /RNDC=1 0 . 

Sets  the  length  of  the  round-robin  scheduling  interval  to  10(10) 
ticks . 

VMR>SET/ SECPOL 
SECPOL=285 • : 640 : 44% 

Displays  the  amount  of  secondary  pool  currently  being  used. 
VMR>SET  / SLAVE=TT3 : 

Sets  TT3 :  to  be  a  slaved  terminal. 


VMR>SET  /SWPR 

SWPR=5 • 


Displays  the  curr 
range . 

VMR>SET  / SWPR=1 0 . 

•ent  value  for 

the 

Executive  swapping  priority 

Sets 

the  Executive  swapping  pri 

lo: 

r  it} 

f  range  to  10(10) . 

VMR>SET  /VT05B 
VT05B=TT4 : 

VT05B=TT5 : 

VT05B=TT6 : 

Displays  all  VT05B  terminals. 
VMR>SET  /WCHK=DK1 : 


Enables  write  checking  on  DKls. 


VMR>SET  /PAR= 

=SYSPAR: 420: 140:SYS 

Defines 

;  a  pai 

rtition  called  SYSPAR  whose  base  address  is  42000(8} 

and  who 

se  length  is  14000(8)  bytes. 
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VMR>SET  /NOPAR=SYSPAR 

El iminatei 

3  the  main  partition  SYSPAR. 

VMR>SET  /PAR=GEN:*:* 

Creates  a 
possible  < 

partition  named  GEN,  setting  the  base  address 
and  making  the  partition  as  large  as  possible. 

as  low  as 

VMR>SET  /POOL=4 20 


Establishes  the  top  of  the  dynamic  storage  region  (pool) . 
Following  this  command,  no  user-defined  partition  can  begin  below 
42000(8) . 

VMR>SET  /POOL 

POOL=1200: 11470. : 11738. :2003 

Shows  that  the  last  virtual  address  in  the  Executive  is  120000, 
the  longest  free  block  is  11470(10)  words,  and  the  total  of  all 
pool  space  is  11738(10)  words.  The  lowest  physical  address  at 
which  a  partition  can  start  is  2003  (32-word  blocks) . 
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TASKLIST 

Use  the  TASKLIST  command  to  display  a  description  of  each  installed 
task  in  the  system.  The  display  contains  several  columns  that  give, 
from  left  to  right,  the  following  information: 

1.  Task  name 

2.  Task  version  identification 

3.  Task  Control  Block  address 

4.  Partition  name 

5.  Task  priority 

6.  Size  of  task  in  bytes  (octal) 

7.  Load  device  identification 

8.  Disk  address  logical  block  number  (in  octal)  on  virgin 

systems,  or  the  image  or  task  file  identification  on  saved 

systems 

9.  Task  memory  state  (saved  systems  only) 

On  RSX-11M-PLUS,  the  display  lists  the  tasks  installed  in  primary  pool 
and  then  those  installed  in  secondary  pool.  The  tasks  in  secondary 
pool  are  indicated  by  a  plus  sign  (+)  . 

Format 


TAS [KLIST] [taskname] 
Parameters 
taskname 


The  name  of  a  single  installed  task,  the  description  of  which  you 
would  like  to  be  displayed. 

Examples 


This  example  is  from 


a  virgin  system: 


VMR>TAS 
TKTN  03.14 
.  .  . MCR  01.01 
MCR. . .  3.3 
. . . INS  4 
. . . LOA  03.3 
. . .UNL  03.4 
VMR> 


035300  GEN 
035174  GEN 
035070  GEN 
035614  GEN 
035510  GEN 
035404  GEN 


248.  00010000 
160.  00040000 
160.  00010000 
100.  00040000 
50.  00040000 
50.  00040000 


LB0:-00631420 
LB0:-00630300 
LB0 : -00627721 
LB0 : -00627333 
LB0 : -00627643 
LB0: -00070512 


On  a  system  image  generated  for  a  PDP-11/70  with  more  than  124K 
words  of  memory,  the  size  field  (sixth  column)  contains  8-diqit 
rather  than  6-digit  numbers. 
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c 


This  example 

is  from  a  saved  system: 

VMR>TAS 

LOR • • • 

08.03 

034210 

LDRPAR 

248.  00003000 

LB0:- 

FILE 

ID 

(1111,12)  FIXED 

TKTN 

03.14 

115424 

GEN 

248.  00010000 

LB0 :  - 

FILE 

ID 

(31540,27) 

MTAACP 

0010 

115214 

GEN 

200.  00013500 

LB0 :  - 

FILE 

ID 

(31461,24) 

MCR. . . 

3.3 

116464 

SYS PAR 

160.  00010000 

LB0 :  - 

FILE 

ID 

(31454,12) 

•  •  • DC  L 

0113A 

115634 

GEN 

160.  00040000 

LB0 :  - 

FILE 

ID 

(31344,53) 

DCL. • • 

0113A 

115530 

GEN 

160.  00010000 

LB0 :  - 

FILE 

ID 

(31345,5) 

. . .MCR 

01.01 

036770 

GEN 

160.  00040000 

LB0 :  - 

FILE 

ID 

(30546,34) 

. . .MOU 

23.00 

036250 

GEN 

160.  00040000 

LB0:- 

FILE 

ID 

(5424,15) 

F11ACP 

M0320 

117674 

GEN 

149.  00065700 

LB0 :  - 

FILE 

ID 

(30101,47) 

DB00F1 

M0320 

117570 

GEN 

149.  00065700 

LBO :  - 

FILE 

ID 

(31370,6) 

COT. . . 

X00.01 

117360 

GEN 

145.  00015400 

LBO:- 

FILE 

ID 

(31336,120) 

. . .DMO 

23.00 

117254 

GEN 

140.  00040000 

LBO:- 

FILE 

ID 

(31346,23) 

...INI 

20.01 

116674 

GEN 

140.  00040000 

LBO:- 

FILE 

ID 

(31424,55) 

. • • UFD 

V0410 

116044 

GEN 

140.  00040000 

LBO :  - 

FILE 

ID 

(31541,34) 

PMD. . . 

3.1 

114630 

GEN 

140.  00023600 

LBO :  - 

FILE 

ID 

(31464,70) 

HRC . .  . 

01.01 

036560 

GEN 

140.  00050400 

LBO :  - 

FILE 

ID 

(31240,21) 

SHF. .  . 

03.01 

115320 

SYS PAR 

105.  00010000 

LBO:- 

FILE 

ID 

(31521,40) 

FXR. .  . 

01 

117104 

GEN 

100.  00003100 

LB02- 

FILE 

ID 

(31371,113) 

...  INS 

4 

116570 

GEN 

100.  00027700 

LBO  2  - 

FILE 

ID 

(31435,12) 

. . . SAV 

04.35 

116254 

TSTPAR 

100.  00040000 

LBO  2  - 

FILE 

ID 

(31475,5) 

SAVTO 

04.35 

036130 

TSTPAR 

100.  00040000 

LBO :  - 

FILE 

ID 

(31475,5) 

. . . PRV 

4.30 

036664 

GEN 

100.  00040000 

LBO  2  - 

FILE 

ID 

(3433,163) 

...  AT . 

04.25 

037254 

GEN 

65.  00057700 

LBO  2  - 

FILE 

ID 

(31421,131) 

. . .BOO 

04.08 

117464 

GEN 

50.  00040000 

LB0  :  - 

FILE 

ID 

(31323,6) 

...  AC  S 

01.1 

115740 

GEN 

50.  00040000 

LBO :  - 

FILE 

ID 

(31321,73) 

. . .HEL 

01.25 

037360 

GEN 

50.  00044100 

LBO:- 

FILE 

ID 

(31416,15) 

The  display  for  a  saved  system  differs  from  the  display  for  a 
virgin  system  in  that  the  file-ID  of  the  task  file,  rather  than 
the  logical  block  number,  is  displayed, 


FIXED  indicates  that  the  task 

is  fixed  in  memory. 

This  example 

is  from  an 

i  RSX-11M-PLUS  saved  system  that 

has 

tasks 

installed  in 

secondary  pool : 

VMR>TAS 

• 

# 

• 

BAPO 

02 

113440 

GEN 

80.  00045700 

LBO:-  FILE 

ID: 

(4332,27) 

QMG. . . 

1.7 

112450 

GEN 

75.  00031400 

LBO:-  FILE 

ID: 

(4366,2) 

LPO 

1.9 

112734 

GEN 

70.  00015400 

LBO:-  FILE 

ID: 

(4354,135) 

LP1 

1.9 

112604 

GEN 

70.  00015400 

LBO:-  FILE 

ID: 

(4354,135) 

SHC. . . 

01.01 

110600 

GEN 

60.  00051700 

LBO:-  FILE 

ID: 

(4360,2) 

SHUTUP 

02 

110320 

GEN 

50.  00011200 

LBO:-  FILE 

ID: 

(4320,65) 

...DMO 

23.20 

006025+ 

GEN 

160.  00015500 

LBO:-  FILE 

ID: 

(4167,35) 

.. .MCR 

2.4 

006037+ 

GEN 

160.  00032000 

LBO:-  FILE 

ID: 

(2132,227) 

. . .MOU 

2502 

006041+ 

GEN 

160.  00040000 

LBO:-  FILE 

ID: 

(4205,13) 

...DCL 

♦ 

• 

* 

00 

006130+ 

GEN 

160.  00035600 

LBO:-  FILE 

ID: 

(2535,1525) 
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TIM 

TIME 

Use  the  TIME  command  to  set  the  time  of  day  and  the  date  or  to 
display  the  time  and  date. 

Formats 

TIM [E]  [hrs :mins [ : secs] ]  [ml/day/year] 
or 

TIM [E]  [hrs:mins[ :secs] ]  [day-m2-year] 

Parameters 

hrs 


Hours  (range  0  through  23). 

mins 

Minutes  (range  0  through  59). 

secs 

Seconds  (range  0  through  59).  This  parameter  is  optional-  the 
default  is  zero. 

ml 

Numeric  representation  of  month  (range  1  through  12). 
m2 


Three-letter  abbreviation  for  month. 


day 


Day  (range  1  through  31). 


year 


Year  (range  0  through  99).  Year  is  relative  to  1900;  thus,  1981 
is  entered  as 
81. 


Examples 

>TIM 

10:23:31  03-MAY-81 

Displays  the  current  system  image  time  and  date. 

>TIM  14:30  4/11/81 

Sets  the  time  to  14:30:00  and  the  date  to  ll-APR-81. 
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TIM  (Cont.) 


Notes 

1.  If  you  specify  neither  time  nor  date,  VMR  displays  the 
current  system  image  time  and  date. 

2.  If  you  specify  the  time  and  date,  VMR  sets  the  system  image 
clock  and  calendar.  If  you  specify  only  the  time,  VMR  sets 
only  the  clock;  if  you  specify  only  the  date,  VMR  sets  only 
the  calendar. 

3.  You  can  specify  the  time  and  date  in  any  order. 

4.  The  form  used  to  specify  the  date  does  not  affect  the  display 
format.  The  date  is  always  displayed  as  day-month-year. 

5.  All  numeric  values  are  decimal.  No  terminating  period  is 
required . 
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UNF 

UNFIX 

Use  the  UNFIX  command  to  free  a  fixed  task  from  the  virtual  memory  of 
the  system  image.  UNFIX  is  the  complement  of  the  FIX  command. 

If  a  fixed  task  exits  or  aborts,  it  still  occupies  the  physical  memory 
in  the  partition.  1 

Format 

UNF [IX]  taskname [/keyword] 

Parameter 


taskname 

The  task  that  you  want  to  unfix  from  memory. 


/keyword 

One  of  the  following  keywords  (RSX-11M-PLU£ 

:  systems  only)  : 

/REG 

/RON 

Keywords 

/REG 

Specifies  that  the  task  to  be  unfixed  is  a 

common  region. 

/RON 

Specifies  that  the  task  is  a  multiuser 

task,  the  read-only 
ry. 

segment  of  which  is  to  be  unfixed  from  memo 

Example 

VMRXJNFIX  XKE 

Unfixes  task  XKE,  freeing  the  partition  in  which  it  resides. 


10-74 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


UNL 


UNLOAD 


Use  the  UNLOAD  command  to  remove  a  loadable  device  driver  from  the 
system  image.  If  a  device  is  attached,  its  driver  cannot  be  unloaded. 

To  unload  a  device  driver  from  the  system  image,  the  driver's  symbol 
definition  file  must  reside  on  LB:  under  the  same  UFD  as  the  UFD  of 
the  system  image  file.  By  convention,  the  system  UIC  is  [1,50]  for  an 
unmapped  system  and  [1,54]  for  a  mapped  system. 

The  UNLOAD  command  cannot  remove  a  loadable  data  base  from  the  system 
image,  even  if  the  data  base  was  loaded  by  means  of  the  LOAD  command. 


Format 

UNL  [OAD]  dd: 

Parameter 
dd  : 

A  2-character  ASCII  device  name 


Example 


VMRMJNL  LP: 

Unloads  the  line  printer  driver  ( LPDRV) . 
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10.6  VMR  ERROR  MESSAGES 


The  following  are  the  VMR  command  error  messages.  Although  just  the 
text  of  the  messages  is  given  here,  the  messages  actually  appear  in 
one  of  the  following  formats: 

VMR  —  *DIAG*  message 


VMR  —  message 


VMR  —  * FATAL*  message 


A  diagnostic  message  usually  indicates  that  something  unexpected  may 
have  happened,  but  it  does  not  interfere  with  VMR's  operation. 

An  unmarked  message  usually  indicates  that  VMR  rejected  the  command 
line.  If  the  offending  line  is  in  an  indirect  command  file,  VMR 
ignores  the  rejected  line  and  attempts  to  execute  the  remaining 
command  lines. 


A  fatal  message  also  indicates  that  VMR  rejected  the  command 
this  case,  however,  VMR  either  exits  or  resets  itself  to  the 
(that  is,  ENTER  FILENAME:).  If  the  offending  line  is  in  an 
command  file,  VMR  aborts  without  attempting  to  execute  the 
command  lines. 


line.  In 
beg  inning 
indirect 
remaining 


VMR  —  Access  to  common  block  denied 

Explanation:  You  attempted  to  install  a  task  that  has  specified 

illegal  access  to  a  shared  region. 

VMR  —  Addressing  extensions  not  supported 

Explanation:  You  attempted  to  install  a  task  that  was  built 

using  the  VSECT  (virtual  section)  directive  into  a  system  image 
that  does  not  support  the  VSECT  feature. 

VMR  —  Alignment  error 


Explanation:  The  base  address  or  size  of  the  partition  being 

created  with  the  SET  command  conflicts  with  existing  partitions 
or  physical  memory. 

VMR  —  Base  address  must  be  on  a  4K  boundary 

Explanation:  The  virtual  base  address  of  the  task  being 

installed  is  not  aligned  on  a  4K  boundary. 

VMR  —  Base  mismatch  common  block  <commonname> 


Explanation:  The  base  address  of  the  partition  does  not  match 

that  of  the  common  block. 


VMR  —  Cannot  fix  an  I/D  space  task 

Explanation:  You  attempted  to  fix  a  task  that  is  built  with  I- 

and  D-space.  Such  tasks  cannot  be  fixed. 

VMR  —  Cannot  fix  a  task  in  a  system  controlled  partition 

Explanation:  This  is  a  VMR  restriction.  To  fix  a  task  in  a 

system-controlled  partition,  use  the  MCR  FIX  command  and  then 
save  the  system  image. 
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VMR  —  Cannot  have  multiple  pool  or  CPU  partitions 

Explanation:  You  attempted  to  create  a  secondary  pool  partition 

in  a  system  that  already  has  one.  There  can  be  only  one 
secondary  pool  partition  in  a  system. 

VMR  —  Cannot  install  tasks  or  commons  from  other  than  LB: 

Explanation:  SAVE  does  not  allow  saving  of  a  system  that  has 
tasks  and/or  commons  that  were  not  installed  from  the  library 
device  LB:.  Therefore ,  a  task  or  common  cannot  be  installed  from 
other  than  LB:. 

VMR  —  Cannot  LOAD/UNLOAD  a  pseudo  device 

Explanation:  When  loading  or  unloading  a  device  driver,  the 
physical  name  of  the  driver  must  be  specified. 

VMR  —  Cannot  UNFIX  a  mapped  common  region 

Explanation:  You  attempted  to  unfix  a  common  region  that  is 

currently  mapped  by  a  task. 

VMR  —  Cannot  UNFIX  the  directive  common 

Explanation:  RSX-11M-PLUS  directive  commons  can  be  removed  but 

not  unfixed.  Because  directive  commons  are  merged  with  DIR11M  as 
they  are  fixed,  the  size  of  a  particular  common  is  unkown. 

VMR  —  Checkpoint  area  too  small 

Explanation:  The  area  allocated  for  checkpointing  in  the  task 

image  file  is  smaller  than  the  partition  into  which  the  task  is 
being  installed.  The  system  image  does  not  support  the  dynamic 
allocation  of  checkpoint  space. 

VMR  —  Checkpoint  space  too  small,  using  checkpoint  file 

Explanation:  This  is  a  warning  message.  The  checkpoint  space 

allocated  in  the  task  image  file  is  too  small  to  hold  the  task 
(usually  because  of  the  /INC  keyword) .  The  system  image  supports 
the  dynamic  allocation  of  checkpoint  space.  It  will  use  the 
checkpoint  file  to  store  the  task  when  it  rolls  it  out  to  disk. 
Since  no  checkpoint  file  exists  when  the  system  is  booted,  you 
should  consider  this  message  to  be  a  fatal  error  if  it  is  issued 
by  any  of  the  system  tasks  while  the  system  is  being  booted. 
These  tasks  are  MCR,  MOU,  and  F11ACP. 

VMR  —  Circular  redirect  error 


Explanation:  The  attempt  to  redirect  a  device  failed  because  it 

would  result  in  a  circular  device  list. 

VMR  —  Command  I/O  error 

Explanation:  The  system  detected  an  I/O  error  during  a  read  from 

an  indirect  command  file. 


VMR 


—  Command  syntax  error  <command-line> 

Explanation:  The  syntax  of  the  command  line  is  incorr 


ect . 
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VMR  —  Common  block  currently  installed 


Explanation:  You  attempted  to  install  a  common  block  that  has 

already  been  installed. 

VMR  —  Common  block  is  task  partition  <commonname> 

Explanation:  A  task's  request  for  access  to  a  common  block  has 
been  rejected  because  the  requested  partition  is  a  task 
partition . 

VMR  —  Common  block  not  loaded  <commonname> 


Explanation:  The  common  block 
message  has  been  linked  to  the 
yet  been  installed. 

User  Action:  The  common  block 
can  be  installed. 


specified  by  VMR  in  the  error 
task,  but  the  common  block  has  not 

must  be  installed  before  the  task 


VMR  —  Common  block  occupied 

Explanation:  You  attempted  to  install  a  task  in  a  common  block 

that  was  already  occupied. 

VMR  —  Common  block  parameter  mismatch  <commonname> 

Explanation:  The  parameters  of  the  common  block  named  in  the 

error  message  do  not  match  the  parameters  in  the  label  block  of 
the  task  that  references  the  common  block. 

VMR  —  Common  block  segment  count  error 

Explanation:  You  attempted  to  install  a  resident  library  with 

overlays,  but  the  number  of  overlay  segments  in  the  task  header 
differs  from  the  number  specified  in  the  segment  descriptors. 

VMR  —  CTB  <name>  does  not  exist 


Explanation:  The  Controller  Table  name  that  you  specified  with 

the  LOAD  /CTB  keyword  does  not  exist  in  the  resident  data  base. 

VMR  —  CTB  name  <name>  is  a  duplicate 

Explanation:  The  loadable  data  base  contains  a  Controller  Table 

(CTB)  with  a  name  that  is  the  same  as  a  CTB  name  in  the  resident 
data  base.  CTB  names  must  be  unique. 

VMR  —  CTB  <name>  not  supported  by  driver  —  not  loaded 

Explanation:  This  is  a  warning  message.  Two  things  could  be  at 

fault: 

1.  The  Driver  Dispatch  Table  in  the  driver  does  not  have 
all  the  Controller  Table  mnemonics  that  the  rest  of  the 
data  base  (that  is,  DCBs  and  CTBs)  implies  that  it 
should  have. 

2.  The  CTB  is  defective.  A  defective  CTB  may  contain  a 
wrong  name  or  it  may  point  at  the  wrong  DCB. 
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VMR  —  Data  space  file  exceeds  available  space  in  system  image 

Explanation:  The  RSX11M.SYS  files  are  not  large  enough  to 

contain  the  data  space  file  DSP11M.SYS. 

VMR  —  DCB  table  for  CTB  <name>  is  full 

Explanation:  LOAD  attempted  to  write  the  address  of  the  Device 

Control  Block  (DCB)  of  the  loadable  data  base  into  the  DCB  table 
of  the  Controller  Table  for  a  multicontroller  device.  There  were 
no  null  entries  in  the  DCB  table.  (See  the  RSX-11M-PLUS  Guide  to 
Writing  an  I/O  Driver .) 

VMR  —  Device  <ddnn:>  is  attached 


Explanation:  You  attempted  to  unload  a  driver  that  has  one  or 

more  of  its  device  units  attached.  The  first  attached  unit  is 
ddnn:.  You  cannot  unload  a  driver  that  has  device  units 
attached . 

VMR  —  Device  <ddnn:>  is  not  in  system 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  save  an  image  on  a  device  that  does  not 
exist  on  the  host  system. 

2.  You  attempted  to  redirect  I/O  requests  to  a  device  that 
does  not  exist  on  the  host  system. 

3.  You  specified  a  device  in  the  LOAD  command  line  for 
which  there  is  no  data  base.  This  is  caused  by  one  of 
two  conditions: 

a.  The  device  does  not  exist  in  the  system  device 
tables . 

b.  You  did  not  declare  the  device  to  be  loadable  and 
therefore  LOAD  cannot  find  a  loadable  data  base  for 
it . 

4.  You  specified  a  device  in  the  command  line  that  has  not 
been  defined  in  the  system  image. 


5.  You  specified  a  device  in  the  DEVICES  command  line  that 
does  not  exist  in  the  system  image. 

VMR  —  Device  not  mounted 

Explanation:  You  did  not  mount  the  device  that  contains  the 

system  image  file. 

VMR  —  Device  not  redirectable 

Explanation:  You  attempted  to  redirect  a  device  that  is  marked 

(in  its  UCB)  as  not  redirectable. 

VMR  —  Device  not  terminal 

Explanation:  You  attempted  to  set  terminal  characteristics  for  a 

device  that  is  not  a  terminal. 
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VMR  —  Device  not  variable  speed  multiplexer 

Explanation:  You  attempted  to  set  the  baud  rate  for  a  terminal 

that  is  not  attached  to  a  DH11  or  DZ11  multiplexer. 

VMR  —  Directive  common  already  loaded 

Explanation:  You  attempted  to  fix  in  the  RSX-11M-PLUS  system 

image  a  directive  common  that  is  already  fixed. 

VMR  —  Directive  common  not  contiguous  to  DIR11M 

Explanation:  Directive  commons  must  be  loaded  contiguous  to 
DIR11M  to  work. 

VMR  —  Directive  common(s)  not  fixed  in  memory 

Explanation:  Not  all  of  the  directive  commons  that  were 
installed  in  the  RSX-11M-PLUS  system  image  have  been  fixed. 

VMR  —  Driver  already  resident 

Explanation:  You  attempted  to  load  a  device  driver  that  is 

already  loaded  or  that  is  permanently  resident  in  the  system 
image . 

VMR  —  Driver  built  with  wrong  STB  file 

Explanation:  The  symbol  definition  file  for  the  driver  you 

attempted  to  load  is  not  compatible  with  the  Executive  symbol 
definition  file  for  the  current  system  image.  This  means  that 
the  driver  has  been  built  for  another  system  and  must  be  rebuilt 
before  you  can  load  it  into  the  current  system. 

Explanation:  The  symbol  definition  file  for  the  driver  you 

attempted  to  unload  is  not  compatible  with  the  symbol  definition 
file  of  the  current  Executive. 

VMR  —  Driver  cannot  be  unloaded 

Explanation:  You  attempted  to  unload  a  permanently  resident 

driver  (that  is,  a  driver  linked  permanently  to  the  Executive) . 

VMR  —  Driver  dispatch  table  is  inconsistent 

Explanation:  You  attempted  to  load  a  driver  whose  driver 

dispatch  table  is  illegally  formatted.  See  the  RSX-11M  or 
RSX-1 1M-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  Driver  not  loaded 

Explanation:  You  specified  a  driver  in  the  UNLOAD  command  line 

that  is  not  resident  in  memory. 

VMR  —  Driver  requires  running  system  for  LOAd/UNLoad 

Explanation:  The  driver  you  requested  has  the  symbols  $ddLOA  or 

$ddUNL  in  its  source.  Support  of  driver  load/unload  calls  can 
only  be  provided  by  the  MCR  LOAD/UNLOAD  commands. 


10-80 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


VMR  —  Executive  common  partition  eliminated 

Explanation:  This  is  a  warning  message.  One  of  the  executive 
common  partitions  has  been  removed.  A  system  generated  with 
executive  common  support  must  have  both  partitions  installed  to 
run . 

VMR  —  Executive  common(s)  not  installed 

Explanation:  This  is  a  warning  message.  For  a  system  generated 
with  executive  common  support,  you  should  install  one  (or  both) 
of  the  commons  before  you  exit  VMR.  Otherwise,  the  system  is 
unusable . 


VMR  —  Executive  too  large 

Explanation:  The  Executive  is  too  large  to  be  accommodated  in 

the  system  image.  This  message  indicates  that  the  Executive  is 
larger  than  20K.  The  system  is  unusable. 

VMR  —  External  headers  not  supported 

Explanation:  You  attempted  to  install  a  task  built  with  external 

headers  in  a  system  that  was  not  generated  with  external  header 
support. 

VMR  —  Feature  not  supported  in  system  image 

Explanation:  You  either  attempted  to  create  secondary  pool  in  a 

system  that  does  not  support  it,  or  you  attempted  to  set  a  device 
public  in  a  system  that  does  not  support  multiuser  protection,  or 
you  attempted  to  enable/disable  the  broadcast  option  for  a 
terminal,  but  the  system  is  not  a  mul ti user/mul ti-CLI  system. 

VMR  —  File  <name>  has  illegal  format 

Explanation:  The  driver's  symbol  definition  file  contains 

illegal  object  code  or  data. 

VMR  —  File  <name>  has  inconsistent  data 


Explanation:  This  message  can  occur  for  the  following  reasons: 


1.  You  attempted  to  fix  a  partition  or  a  task  that  is 
logically  beyond  the  end  of  the  system  image  file. 

2.  The  partition  for  loadable  drivers  is  logically  beyond 
the  end  of  the  system  image  file.  The  system  image  is 
probably  corrupt. 

3.  The  partition  of  the  common  library  you  are  attempting 
to  load  is  logically  beyond  the  end  of  the  system  image 
file. 

VMR  —  File  <name>  not  a  valid  driver  task  image 


Explanation : 

1.  The 

2.  The 

3.  The 


One  of  three  things  has  occurred: 
driver's  task  image  has  been  overlaid, 
driver  has  a  header. 

driver  has  referenced  a  resident  library. 
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VMR  —  File  not  contiguous 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  install  a  task  from  a  noncontiguous 
file.  Task  images  must  be  contiguous  files. 

2.  The  file  ddDRV.TSK  is  not  contiguous.  This  file  must  be 
contiguous  for  a  device  driver  to  be  loaded. 

VMR  —  File  not  found 

Explanation:  You  requested  a  file  that  is  not  in  the  directory 

of  the  volume  you  specified. 

VMR  —  File  not  task  image 

Explanation:  The  data  in  the  label  block  of  the  task  you  tried 

to  install  is  incorrect,  indicating  that  the  file  is  not  a  task 
image . 

VMR  —  Illegal  device/volume 

Explanation:  You  attempted  to  save  your  system  image  on  an 

invalid  device.  Valid  devices  are: 

CT:  Tape  cassette 

DD:  TU58  DECtape  II 

DT:  DECtape 

DX:  RX01  flexible  disk 

DY:  RX02  flexible  disk 

MM:  TE/TU16/TU45/TU77  magnetic  tape 

MS:  TS11 

MT:  TE/TU10/TS03  magnetic  tape 

PP:  Paper  tape 

VMR  —  Illegal  driver  task  APR  usage 

Explanation:  The  device  driver  being  loaded  must  be  built  for 

APR  5  and  must  be  less  than  4K  words. 

VMR  —  Illegal  error  severity  code  <code> 

Explanation:  This  message  indicates  an  internal  failure  in  VMR. 

If  this  error  message  persists,  contact  a  DIGITAL  software 
representative . 

VMR  —  Illegal  file  specification  <filespec> 

Explanation:  The  file  specification  printed  following  the  error 

message  has  an  illegal  format  or  contains  wildcards. 
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VMR  —  Illegal  first  APR 

Explanation:  The  task  you  tried  to  install  was  built  using  an 

incorrect  base  APR.  The  following  rules  apply: 

1.  A  nonpr ivileged  task  must  be  built  with  APR 
base  APR. 

2.  A  privileged  task  that  does  not  map  into  the 
must  be  built  with  APR  0  as  its  base  APR. 

3.  If  the  Executive  is  16K  words  or  less,  a  privi 
that  is  to  map  to  the  Executive  routine 
structures  must  be  built  with  APR  4  as  its  bas 

4.  If  the  Executive  is  20K  words  (or  less  o 
systems) ,  a  privileged  task  that  is  to  i 
Executive  routines  and  data  structures  must 
with  APR  5  as  its  base  APR. 

VMR  —  Illegal  function 

Explanation:  You  entered  a  command  that  VMR  does  not 

or  the  command  line  refers  to  a  feature  that  is  not  su 
the  system. 

VMR  —  Illegal  Get  Command  Line  <error  code> 

Explanation:  This  message  indicates  a  system  failure.  If  the 

error  persists,  contact  a  DIGITAL  software  representative. 

VMR  —  Illegal  keyword  value 

Explanation:  You  entered  a  value  for  a  keyword  that  is  out  of 

range . 

VMR  —  Illegal  operation  for  unmapped  system 

Explanation:  The  SET  /POOLSIZE  keyword  is  valid  only  on  mapped 

systems . 

VMR  —  Illegal  parameter  for  executive  common  partition 

Explanation:  You  specified  a  parameter  with  SET  /MAIN  that  is 

illegal  for  an  executive  common.  The  partition  size  must  be 
200(8)  and  the  partition  type  must  be  COM. 

VMR  —  Illegal  priority 

Explanation:  You  specified  a  priority  for  the  task  being 
installed  that  is  out  of  range  (that  is,  not  1  through  250 
decimal)  . 

VMR  —  Illegal  slave  attribute 

Explanation:  You  attempted  to  install  a  task  with  the  /SLV 

keyword,  but  the  task's  name  is  in  the  form  ...xxx.  The  task  is 
a  prototype  task  and  cannot  be  installed  as  a  slaved  task. 

VMR  —  Illegal  switch  <switch> 

Explanation:  The  switch  following  the  error  message  is  incorrect 

in  the  context  of  the  command  line  you  have  entered. 


as  its 
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s  and  data 
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VMR  —  Illegal  use  of  <pname>  partition  or  common 

Explanation:  You  attempted  to  install  a  task  in  a  CPU  or 

secondary  pool  partition. 

VMR  —  Illegal  use  of  <pname>  partition  or  region 

Explanation:  You  attempted  to  load  a  driver  into  a  common  or 

secondary  pool  partition. 

VMR  —  Illegal  use  of  wildcard 

Explanation:  On  an  unmapped  system,  you  cannot  specify  a 

wildcard  (*)  with  the  following  SET  keywords:  /TOP,  /BOT,  and 
/POOL.  You  also  cannot  use  a  wildcard  for  the  size  parameter  of 
task  partitions. 

VMR  —  Illegal  value  for  symbol  <symname>  in  file  <filename> 

Explanation:  LOAD  or  UNLOAD  has  determined  that  symbol  <symname> 

in  the  STB  <filename>  has  been  defined  to  an  illegal  value.  This 
can  occur  for  several  reasons,  some  general  and  some  specific  to 
individual  symbols.  For  example,  most  symbols  generally  cannot 
be  defined  to  zero  or  to  an  odd  number.  A  specific  example  is 
the  symbol  $INTSV,  which  must  not  be  referenced  by  mapped 
loadable  drivers. 

VMR  —  Incorrect  assignment  of  SY:  or  LB: 

Explanation:  This  is  a  warning  message.  The  device  SY:  or  LB: 

is  not  assigned  to  the  same  device  as  the  system  image  file  you 
are  trying  to  work  with  in  VMR. 

VMR  —  Indirect  command  syntax  error  <command-l ine> 

Explanation:  You  entered  an  improper  indirect  command  file 

specification . 

VMR  —  Indirect  file  depth  exceeded  <command-l ine> 

Explanation:  You  attempted  to  reference  more  than  two  levels  of 

indirect  command  files. 

VMR  —  Indirect  file  open  failure  <command-l ine> 

Explanation:  The  indirect  command  file  specified  in  the  command 

line  could  not  be  opened. 

VMR  —  Install  device  not  LBO: 

Explanation:  You  attempted  to  install  a  task  from  other  than  the 

boot  device. 


VMR  —  Installed  tasks  or  commons  may  no  longer  fit  in  partition 

Explanation:  You  shortened  a  partition  so  that  the  tasks  and/or 
commons  that  are  installed  in  it  may  no  longer  fit.  This  is  a 
warning  message.  VMR  shortens  the  partition  even  though  this 
situation  exists. 
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VMR  —  Interrupt  vector  already  in  use 

Explanation:  The  interrupt  vector  for  the  driver  being  loaded 

does  not  point  to  one  of  the  nonsense  interrupt  entry  points  in 
the  system  image. 

VMR  —  Invalid  driver  data  base  at  offset  xxxx  in  file  <filename> 

Explanation:  The  driver  name  has  an  invalid  data  base  value  at 

offset  xxxx  relative  to  the  symbol  $ddDAT.  (See  the  RSX-11M  or 
RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver . 

VMR  —  Invalid  interrupt  vector 

Explanation:  You  specified  an  interrupt  vector  address  in  the 

driver  data  base  that  is  too  high  for  the  system  image. 

VMR  —  Invalid  keyword 

Explanation:  You  specified  a  keyword  that  is  incorrect  in  the 

context  of  the  command. 

VMR  —  Invalid  record  address  for  file  <filename> 

Explanation:  LOAD  has  attempted  to  write  outside  of  the  system 

image  file  or  at  a  byte  boundary.  Three  possible  causes  are: 

1.  A  corrupted  system  image 

2.  An  STB  file  that  does  not  match  the  system  image 

3.  An  internal  problem  in  VMR 
VMR  —  Invalid  speed 

Explanation:  This  message  can  occur  for  two  reasons: 

1.  You  requested  a  speed  that  the  multiplexer  line  you 
specified  does  not  support. 

2.  You  specified  unequal  receive  and  transmit  speeds  for  a 
DH11  or  DZ11.  The  DH11  and  DZ11  multiplexers  do  not 
support  split  speeds. 

VMR  —  Invalid  time  parameter 

Explanation:  The  time  field  you  specified  in  the  RUN  command 

line  is  incorrect. 

VMR  —  Invalid  UIC 

Explanation:  You  specified  an  illegal  value  for  either  a  group 

number  or  a  member  number.  The  numbers  must  be  from  1  through 
377(8) . 

VMR  —  I/O  error  on  input  file  <filename> 

Explanation:  An  input  I/O  error  occurred  on  the  indicated  file. 

VMR  —  I/O  error  on  output  device 

Explanation:  SAVE  has  encountered  an  I/O  error  on  the  output 

device  while  writing  the  system  image. 
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VMR  —  I/O  error  on  output  file  <filename> 

Explanation:  An  output  I/O  error  occurred  on  the  indicated  file. 

VMR  —  Keyword  not  supported  for  this  terminal  driver 

Explanation:  The  terminal  driver  selected  during  system 

generation  does  not  support  the  specified  SET  keyword.  For 

example,  typeahead  is  a  full-duplex  terminal  driver  option  only 

and  your  system  uses  the  half-duplex  driver. 

VMR  —  KRB  <KRBname>  interrupt  vector  <octal-number>  in  use 

Explanation :  You  attempted  to  load  a  driver  that  specifies  an 

interrupt  vector  that  is  not  pointing  to  a  nonsense  interrupt 
entry  point  address.  This  is  usually  caused  by  a  previously 
loaded  driver  that  has  used  this  vector. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VMR  —  KRB  <KRBname>  interrupt  vector  <octal-number>  too  high 

Explanation:  You  attempted  to  load  a  driver  that  specifies  an 

interrupt  vector  address  that  is  higher  than  the  highest 

permissible  vector  address  in  the  system. 

When  you  get  this  message,  LOAD  has  loaded  the  driver  correctly, 
but  it  has  not  overwritten  the  interrupt  vector. 

VMR  KRB  <KRBname>  not  in  loadable  data  base 

Explanation:  You  attempted  to  load  the  driver  for  a 

multicontroller  device  with  a  loadable  data  base.  The  special 
symbol  (KRBname)  that  defines  the  location  of  the  KRB  in  the 
multicontroller  device's  CTB  table  is  not  defined  in  the  loadable 

data  base.  See  the  RSX-1 1M-PLUS  Guide  to  Writing  an  I/O  Driver. 

VMR  —  KRB  table  of  CTB  <CTBname>  will  not  accept  KRB  <KRBname> 

Explanation:  You  attempted  to  load  the  driver  for  a 

multicontroller  device  with  a  loadable  data  base.  If  this 

operation  is  to  be  successful,  two  conditions  must  exist: 

1.  The  appropriate  slot  in  the  CTB  (Controller  Table)  must 
exist . 

2.  The  slot  in  the  CTB  must  be  unused. 

When  VMR  issues  this  error  message,  one  of  these  conditions  does 
not  exist.  See  the  RSX-11M-PLUS  Guide  to  Writing  an  I/O  Driver. 


VMR  —  Length  mismatch  common  block  <blockname> 

Explanation:  The  length  parameter  for  the  common  block,  as 
described  in  the  label  block  for  the  task  image,  does  not  match 
the  corresponding  length  parameter  defined  in  the  system  image. 
A  task's  label  block  data  must  match  system  data  for  that  task 
before  it  can  be  installed. 
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VMR  —  Line  not  DZ11 


Explanations  You  attempted  to  set  a  line  to  remote  that  is  not 
attached  to  a  DZ11,  but  your  system  uses  the  half-duplex  terminal 
driver • 


VMR  —  Loadable  driver  larger  than  4K 

Explanations  This  is  a  warning  message.  You  are  loading  a 

driver  that  is  larger  than  4K  words. 

VMR  —  Loadable  driver  support  not  in  system 

Explanations  You  attempted  to  load  a  device  into  a  system  image 
that  does  not  contain  the  Executive  routine  $INTSI.  The  routine 
is  needed  to  support  loadable  device  drivers. 

VMR  —  Logical  device  not  in  system 

Explanations  The  device  you  specified  has  not  been  defined  and 
therefore  ASSIGN  could  not  find  it  in  the  logical  device 
assignment  table. 

VMR  —  LUN  out  of  range 

Explanations  You  attempted  to  reassign  a  LUN  for  a  task  that  is 
higher  than  the  maximum  number  of  LUNs  allocated  for  the  task 
when  it  was  built. 

VMR  —  No  checkpoint  space,  assuming  not  checkpointable 

Explanations  This  is  a  warning  message.  You  attempted  to 
install  a  task  as  checkpointable  that  was  not  built  as 
checkpointable.  This  means  that  there  is  no  checkpoint  space 
allocated  in  the  task  image  file.  Since  the  system  image  does 
not  support  the  dynamic  allocation  of  checkpoint  space,  INSTALL 
does  not  consider  the  task  to  be  checkpointable. 

VMR  —  No  checkpoint  space  or  dynamic  checkpoint  file 

Explanations  You  attempted  to  install  a  task  built  with  external 
headers  or  as  checkpointable,  but  the  task  does  not  have  any 
checkpoint  space  and  the  system  does  not  have  a  checkpoint  file. 

VMR  —  No  LUNs 

Explanations  The  task  that  you  specified  as  an  argument  of  the 
LUN  command  does  not  have  any  logical  units  assigned  to  it.  This 
is  not  an  error  message;  rather,  it  is  simply  an  indication  that 
there  are  no  assignments  to  display. 

VMR  —  No  pool  space 

Explanations  The  pool  space  required  to  load  the  driver  is  not 
available  in  the  system  image. 

VMR  —  No  room  available  in  STD  for  new  task 

Explanations  There  is  no  dynamic  storage  available  to  make  an 
entry  in  the  System  Task  Directory  (STD).  The  task  cannot  be 
installed . 
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VMR  —  No  table  space  for  optional  directive  common 

Explanation:  You  attempted  to  fix  a  directive  common  in  the 
RSX-1 1M-PLUS  system  image,  but  the  extra  slots  built  into  the 
system  data  base  for  unrequired  directive  commons  have  all  been 
used  . 


VMR  —  Nonexistent  memory 

Explanation:  You  attempted  to  define  a  partition  in  nonexistent 

memory, 

VMR  —  Not  enough  APRS  for  task  image 

Explanation:  The  Task  Builder  allows  you  to  specify  the  virtual 
base  address  of  a  task  image  as  a  multiple  of  4K.  Privileged 
tasks  that  access  the  Executive  start  at  either  virtual  address 
100000(8)  for  a  16K  Executive  or  at  virtual  address  120000(8)  for 
a  20K  Executive,  If  the  virtual  base  address  of  the  task  is  set 
too  high,  there  are  not  enough  APRS  remaining  to  map  the  task 
image.  (See  the  RSX-11M/M-PLUS  Task  Builder  Manual  for 
information  on  privileged  tasks.) 

VMR  —  Old  device  attached 

Explanation:  You  attempted  to  redirect  an  attached  device. 

VMR  —  Open  failure  on  file  <filename> 


Explanation:  The  indicated  file  cannot  be  opened. 

VMR  —  Operation  cannot  extend  above  first  124. K  of  memory 
This  message  can  occur  for  the  following  reasons: 

1.  On  RSX-1 1M ,  you  attempted  to  fix  a  task  above  124K 

words.  The  largest  system  that  can  be  saved  is  124K 
words.  If  FIX  allowed  you  to  fix  a  task  above  this 

limit,  the  task  would  be  lost  when  the  system  was  saved. 

2.  You  attempted  to  create  with  the  SET  command  a  CPU 

partition  whose  upper  limit  is  above  124K  words. 

VMR  —  Operation  not  allowed  for  <ptype>  partitions 

Explanation:  You  attempted  a  SET  operation  that  is  not  allowed 

for  the  type  of  partition  specified  in  the  error  message. 

VMR  —  Optional  directive  common  successfully  loaded 

Explanation:  VMR  has  successfully  fixed  in  the  system  image  a 

directive  common  that  is  not  one  of  the  commons  required  bv 
RSX-1 1M-PLUS  (DIR11M  and  DR211M) . 

VMR  —  Partition  already  exists 


Explanation:  This  message  can  occur  for  the  following  reasons: 


1. 


You  attempted  to  define  a  partition,  using  the  SET 
command,  with  a  name  already  in  use  as  a  partition  name. 


2.  You  attempted  to  define  a  subpartition,  using  the  SET 

command,  but  there  are  no  more  subpartition  slots 
available . 
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VMR  —  Partition  or  common  region  is  busy 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  a  task  or  common  region  in  a 
partition  that  is  full.  The  task  or  region  cannot  be 
fixed . 

2.  You  attempted  to  load  a  device  driver  into  a  partition, 
but  the  partition  is  full. 

3.  You  attempted  to  remove  a  partition  that  still  has  tasks 
installed  in  it.  The  partition  cannot  be  removed. 

VMR  —  Partition  <pname>  is  a  common 

Explanation:  You  attempted  to  load  a  device  driver  into  a  common 

partition.  This  cannot  be  done. 

VMR  —  partition  <pname>  is  not  a  common 

Explanation:  Partition  <pname>  was  found,  but  it  is  not  a  common 

partition . 

VMR  —  Partition  <pname>  is  too  small 

Explanation:  You  attempted  to  load  the  driver  into  a  partition 

that  is  either  too  small  for  the  driver  or  that  does  not 
currently  have  enough  space  for  the  driver.  Or,  you  attempted  to 
install  a  task  that  is  too  large  for  the  specified  partition. 

VMR  —  Partition  <pname>  not  in  system 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  The  partition  you  specified  in  the  command  line  is  not 
in  the  system  image. 

2.  You  attempted  to  load  a  driver  into  a  partition  that 
does  not  exist  in  the  system,  or  LOAD  found  a  symbol 
$xxCOM  in  the  driver  and  partition  xxCOM  does  not  exist 
in  the  system. 

VMR  —  partition  <pname>  not  in  system,  defaulting  to  GEN 

Explanation:  This  is  a  warning  message.  You  attempted  to 

install  a  task  in  a  partition  that  does  not  exist.  VMR  will  try 
to  install  the  task  in  the  partition  GEN. 

VMR  —  Partition  not  system  controlled 

Explanation:  The  SET  command  keywords  /TOP  and  /BOT  are  valid 

only  for  system-controlled  partitions. 

VMR  —  Partition  reduced  to  executive  common  size 

Explanation:  This  is  an  informational  message.  When  an 

executive  common  is  installed  in  its  partition,  the  partition  is 
reduced  to  the  top  of  the  common  to  eliminate  any  unused  space  in 
the  partition. 
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VMR  —  Privileged  task  overmaps  I/O  page 

Explanation:  This  message  pertains  to  the  installation  of  a 

privileged  task. 

A  privileged  task  that  is  mapped  into  the  Executive  is  often 
mapped  to  the  I/O  page  as  well.  However,  many  privileged  tasks 
do  not  require  access  to  the  I/O  page  and  can  use  the  extra  4K  of 
address  space  that  would  be  allocated  to  the  I/O  page  for  the 
task  image.  This  message  warns  that  a  privileged  task  that  may 
require  access  to  the  I/O  page  does  not  have  that  access.  If  the 
task  does  not  require  access  to  the  I/O  page,  this  message  can  be 
ignored . 

VMR  —  Privileged  task  larger  than  12K 

Explanation:  You  attempted  to  install  a  privileged  task  that  is 

larger  than  12K  words.  (See  the  RSX-11M/M-PLUS  Task  Builder 
Manual  for  information  on  privileged  tasks.) 

VMR  —  Pool  link  error  at  xxxx  Block=yyyy  zzzz 

Explanation:  When  SET  /POOL  traced  the  pool  linkage,  it  detected 
an  error  at  location  xxxx  in  the  system  image.  The  contents  of 
xxxx  is  yyyy  and  the  contents  of  xxxx+2  is  zzzz. 

VMR  —  Pseudo  device  assignment  error 

Explanation:  You  attempted  to  assign  a  logical  device  name  to  a 

pseudo  device.  Logical  device  names  cannot  be  assigned  to  pseudo 
devices . 

VMR  —  Pseudo  device  redirect  error 

Explanation:  You  attempted  to  redirect  one  pseudo  device  to 

another  pseudo  device.  This  is  not  allowed. 

VMR  —  R/o  partition  <pname>  not  in  system,  defaulting  to  task's 

Explanation:  You  specified  a  read-only  partition  that  does  not 

exist  in  the  system.  INSTALL  will  place  the  read-only  portion  of 
your  multiuser  task  into  the  same  partition  as  the  read/write 
portion  of  the  task. 

VMR  —  Receive  data  or  by  reference  list  not  empty 

Explanation:  A  task  with  entries  in  its  receive  queues  cannot  be 

removed  from  the  system  image. 

VMR  —  Space  used 

Explanation:  You  attempted  to  create  a  partition  in  a  storage 

area  that  is  already  occupied. 

VMR  —  Specified  partition  for  common  block 

Explanation:  You  attempted  to  install  a  task  in  a  common  block. 
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VMR  —  Specified  partition  too  small 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  install  a  task  into  a  partition  that  is 
smaller  than  the  task. 

2.  You  attempted  to  install  a  driver  into  a  partition  that 
is  smaller  than  the  driver. 

VMR  —  Symbol  <symname>  is  doubly  defined  by  file  <filename> 

Explanation:  The  symbol  symname  is  defined  twice  in  the 

specified  file.  Duplicate  symbols  are  illegal.  The  driver  is 
not  loaded  or  unloaded. 

VMR  —  Symbol  <symname>  is  undefined  in  file  <filename> 

Explanation:  LOAD  found  the  symbol  symname  in  the  specified 

file,  but  the  symbol  is  not  defined. 

VMR  —  Syntax  error 

Explanation:  You  have  typed  the  command  line  incorrectly. 

VMR  —  System  image  is  not  RSX-11M-PLUS 

Explanation:  You  attempted  to  use  RSX-11M-PLUS  VMR  on  a 

non-RSX-llM-PLUS  system  image  file. 

VMR  —  System  image  is  RSX-11M-PLUS 

Explanation:  You  attempted  to  use  RSX-11M  VMR  on  an  RSX-11M-PLUS 

system  image  file. 

VMR  —  Task  active 

Explanation:  The  task  you  specified  as  an  argument  of  the 

command  is  active. 

VMR  —  Task  and  partition  bases  mismatch 

Explanation:  The  base  of  the  partition  does  not  match  that  of 

the  task  being  installed  or  of  the  driver  being  loaded.  This 
message  applies  only  to  unmapped  systems. 

VMR  —  Task  or  common  region  already  fixed 

Explanation:  You  attempted  to  fix  a  task  or  common  region  in 

memory  that  is  already  fixed. 

VMR  —  Task  has  attached  common  regions 

Explanation:  This  message  can  occur  for  the  following  reasons: 

1.  You  attempted  to  fix  or  unfix  a  task  in  memory  that  is 
linked  to  a  shared  region.  VMR  cannot  fix  or  unfix  such 
tasks . 

2.  You  attempted  to  remove  a  task  that  is  linked  to  a 
shared  region  from  the  system  image.  VMR  cannot  remove 
such  tasks. 
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VMR  —  Task  image  currently  installed 

Explanation:  You  attempted  to  install  a  checkpointable  task  that 

has  checkpoint  space  allocated  in  its  task  image.  The  task  has 
already  been  installed. 

The  system  allows  you  to  install  checkpointable  tasks  more  than 
once  subject  to  the  following  rules: 

1.  You  must  allocate  checkpoint  space  for  the  task  in  a 
system  checkpoint  file,  or 

2.  You  must  use  a  different  name  for  the  task  each  time  you 
install  it. 

VMR  —  Task  image  I/O  error 

Explanation:  The  task  cannot  be  installed  or  the  driver  cannot 

be  loaded.  VMR  could  not  read  the  task  image  file  or  could  not 
rewrite  the  task  image  header.  The  specified  device  may  be 
write-locked . 

VMR  —  Task  image  virtual  address  overlaps  common  block  <blockname> 

Explanation:  The  virtual  addresses  you  reserved  for  the  task 

image  overlap  those  you  reserved  for  the  common  block  specified 
in  the  error  message.  Corruption  of  the  task  image  file  may  have 
caused  the  overlap. 

VMR  —  Task  is  checkpointable 

Explanation:  You  attempted  to  fix  a  checkpointable  task  in 

memory.  Checkpointable  tasks  cannot  be  fixed. 

VMR  —  Task  is  not  multi-user 

Explanation:  You  attempted  to  fix  in  memory  the  read-only 
portion  of  a  multiuser  task,  but  the  task  you  named  in  the 
command  line  is  not  a  multiuser  task. 

VMR  —  Task  name  already  in  use 

Explanation:  You  attempted  to  install  a  task  of  the  same  name  as 

that  of  one  already  installed  in  the  system  image. 

VMR  —  Task  not  installed  with  external  header 

Explanation:  This  is  a  warning  message  to  indicate  that  the 

specified  task  is  installed  with  its  header  in  pool  (the  dynamic 
storage  region)  . 

VMR  —  Task  not  in  system 

Explanation:  You  referenced  a  task  that  is  not  installed  in  the 

system. 

VMR  —  Task  not  removed,  CLI  has  messages  enabled 

Explanation:  You  attempted  to  remove  a  CLI  task  that  is  able  to 

receiye  messages  from  the  system.  The  task  may  have  messages 
that  it  has  not  received  yet,  so  the  remove  request  is  aborted. 


10-92 


VIRTUAL  MONITOR  CONSOLE  ROUTINE  (VMR) 


VMR  —  Task  or  common  not  in  memory 

Explanations  You  attempted  to  remove  a  task  or  common  from  the 
system  that  is  checkpointed  and ,  therefore ,  not  in  memory • 

VMR  —  Task  or  common  region  is  not  fixed 

Explanations  You  attempted  to  unfix  a  task  that  is  not  fixed  in 
the  system  image. 


VMR  —  Task  or  common  region  not  in  system 

Explanations  You  referenced  a  task  or  common  region  that  has  not 
been  installed  in  the  system  or,  on  RSX-11M-PLUS ,  you  attempted 
to  run  a  prototype  task. 

VMR  —  Task  requires  system  controlled  partition 

Explanations  You  attempted  to  install  a  task  that  was  built  with 
external  header  (/XH)  support  and  as  checkpointable  ( TKB  /CP,  INS 
/ CKP=YES) .  Such  tasks  must  be  installed  in  a  system-controlled 
partition . 


VMR  —  TI  redirect  error 


Explanations  You  attempted  to  redirect  the  pseudo  device  TI:. 
TI:  cannot  be  redirected. 


VMR  —  Too  many  common  block  requests 

Explanations  You  attempted  to  install  a  task  that  contains  too 
many  common  block  requests.  A  task  is  limited  to  seven  common 
block  references. 

VMR  —  Too  many  LUNs 

Explanations  You  attempted  to  install  a  task  that  contains  more 
than  250(10)  LUN  assignment  requests. 

VMR  —  Too  many  symbols  of  the  form  $xxTMO  in  file  name 

Explanations  LOAD  is  attempting  to  extract  symbols  of  the  form 
$xxTM0  from  the  driver's  symbol  definition  file.  There  are  more 
symbols  of  this  form  than  LOAD  can  process. 

VMR  —  Top  of  pool  set  to  <value>,  requested  amount  not  available 

Explanations  You  requested  more  pool  space  than  the  system  can 
provide.  The  system  provides  as  much  as  possible  in  this  case. 

VMR  —  Undefined  common  block  <blockname> 

Explanations  You  attempted  to  install  a  task  that  references  a 
common  block  that  is  not  defined  in  the  system  image.  This 
message  may  indicate  that  the  task  was  built  for  another  system. 


VMR  —  Unknown  partition 


Explanations  You  attempted 
not  exist  in  the  system. 


an  operation  on  a 


parti tio 


n  that  does 
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VMR  —  User  D-space  not  supported 

Explanation:  An  attempt  was  made  to  install  a  task  with  separate 

instruction  and  data  space  on  a  system  that  does  not  support  user 
D-space.  (User  D-space  is  a  system  generation  option.) 

VMR  —  Virtual  terminal  error 

Explanation:  You  attempted  to  enable ,  using  the  SET  command ,  a 

terminal  option  for  a  virtual  terminal. 

VMR  —  Write  check  not  supported  for  device 

Explanation:  You  attempted  to  enable  write  checking  for  a  device 

that  does  not  support  it.  Write  checking  is  supported  for  all 
disks ,  except  RLOls  and  RL02s  (DL : ) ,  and  RXOls  (DX:). 
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COMMAND  LINE  INTERPRETERS 


11.1  INITIAL  CONCEPTS 

A  command  line  interpreter,  or  CLI,  is  a  task  that  services 
unsolicited  commands  meant  for  the  operating  system  or  an  application. 
These  commands  are  not  prompted  for  by  any  task  nor  are  they  given  to 
a  task  by  a  read  operation  on  a  terminal. 

The  best-known  CLI  on  RSX-11M/M-PLUS  systems  is  MCR,  which  controls 
the  operating  system.  MCR,  like  any  other  CLI,  receives  command  lines 
that  originate  as  unsolicited  input  typed  on  a  terminal  or  as  issued 
by  a  task  using  an  Executive  directive.  Since  all  lines  typed  on  a 
terminal  are  seen  by  the  CLI  (except  those  used  to  satisfy  a  task's 
read  requests),  the  CLI  task  is,  in  effect,  a  complete  user  interface. 
This  control  over  the  user  at  the  terminal  is  absolute.  There  is  no 
way  to  bypass  a  CLI  to  send  commands  to  the  system  or  application. 

A  CLI  is  also  an  efficient  means  of  interfacing  an  application  command 
processor  to  any  number  of  terminals,  since  no  read  QIO  or  character 
AST  processing  is  involved.  The  input  from  the  terminal  simply  goes 
to  the  CLI  by  default  for  processing. 

This  chapter  introduces  the  concepts  of  CLIs  on  RSX-11M/M-PLUS 
systems.  The  chapter  provides  enough  information  to  allow  a 
programmer  to  write  application-specific  CLIs.  A  brief  description  of 
three  DIGITAL  CLIs  supplied  with  the  system  illustrates  these 
concepts.  These  three  system  CLIs  do  quite  different  things  with  the 
command  lines  they  process,  but  the  basic  goal  of  each  is  the  same: 
to  provide  a  specific  environment  for  the  terminal  user.  This  basic 
goal  also  applies  to  any  application-specific  CLIs,  which,  of  course, 
may  perform  completely  different  command  processing  functions.  A 
simple  sample  CLI  -  written  in  both  FORTRAN  and  MACRO-11  -  is  included 
in  this  chapter.  The  example  is  also  included  on  the  distribution  kit 
in  either  LB: [1,2]  with  the  HELP  files  or  in  the  new-user  account 
[200,1]  as  TMCLI . MAC  and  TMCLI.FTN.  See  your  system  manager  for  more 
information.  The  example  illustrates  the  CLI  interface  and  should 
clarify  the  basic  operations  of  a  CLI. 


NOTE 

This  chapter  describes  features 
available  on  RSX-11M  and  RSX-11M-PLUS . 
RSX-11S  systems  include  Basic  MCR,  but 
do  not  support  the  CLI  features 
discussed  in  this  chapter. 
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11.1.1  MCR  -  The  Traditional  RSX-11M/M-PLUS  CLI 

The  most  important  CLI  on  RSX-11M/M-PLUS  systems  is  MCR.  MCR  receives 
commands  from  the  terminal  and  executes  them  to  control  the  system. 
MCR  is  a  set  of  privileged  tasks.  These  tasks  call  Executive  routines 
and  interact  with  the  system's  data  base.  Therefore,  MCR  is  tied  very 
closely  to  the  Executive.  This  bond  is  necessary  because  of  MCR's 
function  in  system  control  and  has  nothing  to  do  with  MCR's  role  as  a 
CLI. 

Most  other  CLIs  interact  with  an  application  running  on  the  system, 
rather  than  with  the  system  itself.  Therefore  the  CLI  designer  need 
not  have  any  knowledge  of  RSX-11M/M-PLUS  internals.  In  fact,  the 
resulting  CLI  need  not  even  be  privileged.  The  only  similarity 
between  MCR  and  other  CLIs  is  that  any  CLI  controls  the  terminals 
associated  with  it  just  as  MCR  does.  Every  terminal  on  an 
RSX-1 1M/M-PLUS  system  is  set  to  some  CLI.  Users  can  do  nothing  on 
their  terminals  that  their  CLI  does  not  permit.  The  CLI  controls  the 
use  of  the  terminal. 


NOTE 


While  MCR 

is  a 

CLI, 

it  is 

a  special  CLI. 

MCR  does 

not 

use 

the 

CLI  interface 

directives 

because 

it 

must  work  on 

systems 

that 

do 

not 

support  these 

directives.  Therefore,  MCR  is  not  a 
pattern  for  other  RSX-11M/M-PLUS  CLIs. 


11.1.2  DCL  -  DIGITAL  Command  Language 

The  DIGITAL  Command  Language  (DCL)  interpreter  is  a  CLI  that  does  not 
actually  execute  any  commands.  DCL  provides  an  interface  to  operating 
system  features  by  translating  the  commands  it  receives  in  DCL  syntax 
to  the  equivalent  MCR  commands.  DCL  then  passes  the  translated 
command  line  to  the  appropriate  MCR  task  or  utility  for  execution. 
The  CLI  interface  hides  this  operation  from  the  user  at  the  terminal, 
who  does  not  need  to  know  about  MCR  or  the  utilities.  DCL  is  oriented 
towards  operations,  such  as  COPY  or  LINK,  rather  than  towards  tasks 
like  PIP  and  TKB.  DCL  presents  a  totally  different  external  interface 
to  RSX-1 1M/M-PLUS ,  one  that  is  easier  to  learn  and  use  than  MCR.  This 
makes  it  possible  for  less  technical  users  to  do  work  on 
RSX-1 1M/M-PLUS . 


11.1.3  RMT  -  DECnet  Remote  Terminal  Facility 

The  RMT  task  is  a  CLI  that  gathers  commands  from  the  terminals 
associated  with  it  and  sends  them  over  a  DECnet  network  to  be  executed 
on  a  remote  RSX-11M/M-PLUS  system.  The  RMT  interface  provides  a 
mechanism  for  command  handling  with  a  minimum  of  overhead  or  effect  on 
user  tasks.  RMT  is  different  from  DCL:  RMT  does  not  interpret  the 
command  strings  it  handles,  while  all  DCL  does  is  interpret  strings. 
All  the  interpretation  and  execution  of  commands  passed  through  RMT  is 
done  by  the  CLI  that  receives  the  commands  on  the  remote  system. 
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11.2  WRITING  AN  APPLICATION  CLI 

A  CLI  is  an  RSX-11M/M-PLUS  task  like  any  other.  It  need  not  be 
privileged,  unless  the  application  requires  it.  Any  alternate  CLI  is 
expected  to  interact  with  the  operating  system  in  a  certain  way, 
however.  This  is  necessary  to  synchronize  with  the  operating  system 
in  command  handling  and  prompting.  This  interaction  is  achieved 
through  a  set  of  Executive  directives  for  CLIs. 


11.2.1  Executive  Directives  for  CLIs 

The  most  important  directive  is  GCCI$  (Get  Command  for  Command 
Interpreter).  GCCI$  must  be  used  by  every  CLI,  no  matter  what  the  CLI 
does.  GCCI$  supplies  a  command  to  the  CLI  from  a  queue  maintained  by 
the  system.  It  also  controls  the  internal  status  bits  necessary  for 
correct  synchronization  of  prompting  and  general  command  handling  in  a 
manner  transparent  to  the  CLI  task. 

Other  CLI  directives  include: 

1.  RPOI $  (Request  and  Pass  Offspring  Information)  and  SDRP$ 
(Send,  Request,  and  Pass),  which  can  be  used  to  pass  the 
responsibility  for  handing  a  command  off  to  another  task  so 
the  CLI  is  free  to  handle  another  command. 

2.  SCAA$  (Specify  Command  Arrival  AST),  which  specifies  an  AST 
in  the  CLI  whenever  a  command  arrives  for  processing  by  the 
CLI. 

3.  GCI 1$  (Get  Command  Interpreter  Information) ,  which  returns 
information  about  a  terminal  or  CLI  to  the  task. 

See  the  RSX-11M/M-PLUS  Executive  Reference  Manual  for  a  complete 
description  of  these  directives. 


11.2.2  Basic  Interaction  with  the  Operating  System 

Before  a  CLI  can  process  commands,  it  must  be  made  known  to  the 
system.  This  is  done  by  installing  the  CLI  task  with  the  /CLI=YES 
switch  and  then  initializing  the  CLI  with  the  CLI  /INIT  command.  This 
process  creates  an  internal  data  structure  that  allows  the  system  to 
recognize  the  existence  of  the  CLI.  See  the  RSX-1 1 M/M- PLUS  MCR 
Operations  Manual  for  a  description  of  the  INSTALL  command  and  the  CLI 
commands . 

A  CLI's  operation  starts  when  a  command  is  entered  into  the  system. 
The  command  may  originate  as  a  command  line  typed  on  a  terminal  or 
from  an  Executive  directive  issued  by  a  task.  The  source  of  the 
command  is  generally  irrelevant  to  the  CLI.  The  command  is  processed 
first  by  the  system  command  dispatcher  (the  MCR...  task).  This  task 
puts  the  command  into  a  FIFO  queue  of  commands  to  be  retrieved  by  the 
CLI.  The  CLI  associated  with  the  terminal  from  which  the  command 
originated  is  then  requested  to  run  (or  unstopped  if  it  is  already 
active) .  The  CLI  gets  the  command  from  the  system  by  issuing  the 
GCCI $  directive.  This  directive  removes  a  command  from  the  CLI's 
queue  and  copies  it  into  a  buffer  in  the  CLI's  task  space.  GCCI$  can 
also  supply  information  about  the  source  terminal  to  the  CLI. 
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Once  the  CLI  has  the  command ,  it  is  free  to  process  it  in  any  manner 
it  chooses.  Generally  this  involves  executing  the  command,  or  passing 
the  command  to  another  task  for  execution.  If  the  CLI  is  going  to 
pass  the  command  to  another  (non-CLI)  task,  it  should  use  the  RPOI$  or 
SDRP$  directive  to  do  this,  assuming  the  CLI  has  no  further  interest 
in  the  command.  These  directives  propagate  the  information  the  system 
needs  for  controlling,  prompting  and  getting  exit  status  back  to  a 
parent  task,  if  any.  The  CLI's  obligations  to  the  command  are 
complete  once  the  command  has  been  passed  off.  There  is  no  reason  for 
the  CLI  to  get  involved  again.  This  is  the  recommended  procedure  for 
handling  commands,  as  it  avoids  the  wait  for  the  preceding  command  to 
complete  execution.  DCL  works  in  this  way:  translating  a  command 
into  a  different  format  and  dispatching  it  to  another  task  for 
execution. 

CLIs  that  process  commands  themselves  should  be  very  careful  about 
handling  any  possible  delays  in  execution.  This  is  especially  true  if 
the  CLI  is  to  do  I/O  to  a  terminal;  this  means  any  terminal  I/O, 
including  prompts  for  input.  Otherwise,  it  would  be  very  easy  for  one 
user  to  suspend  command  handling  by  not  responding  to  a  prompt  or  by 
typing  CTRL/S. 

Once  a  CLI  has  completed  processing  a  command,  it  must  reissue  the 
GCCI$  directive  to  get  any  other  command  which  may  have  been  queued  to 
it.  If  the  CLI  wants  to  stop  or  exit  when  no  commands  are  queued  to 
it,  it  should  do  this  by  issuing  the  GCCI$  directive  with  the 
appropriate  no-command  action  specified.  This  prevents  a  command 
queued  between  the  return  from  the  GCCI$  and  the  issuance  of  an  EXIT 
or  STOP  directive  from  being  lost,  or  not  processed  until  the  next 
command  is  queued. 


11.2.3  Task  Names  for  CLIs 

CLIs  can  be  installed  with  task  names  in  the  form  ...xxx  (commonly 
called  a  prototype  task  name)  or  with  names  in  some  other  legal  form, 
such  as  xxxxxx  (commonly  called  a  conventional  task  name) . 

If  the  CLI  has  a  prototype  task  name,  the  system  creates  a  separate 
copy  of  the  CLI  each  time  a  command  is  entered  on  a  terminal  set  to 
that  CLI.  The  task  is  named  xxxtnn,  following  the  same  general  rule 
as  any  other  task  installed  in  the  system  with  a  prototype  task  name. 
Each  copy  of  the  CLI  runs  with  the  same  TI :  and  UIC  as  that  of  the 
terminal  the  command  came  from.  These  tasks  should  exit  when  there  is 
no  work  left  for  them  to  do. 

If  the  CLI  has  a  conventional  task  name,  all  commands  from  all 
terminals  associated  with  the  CLI  are  queued  to  a  single  copy  of  the 
task.  This  task  runs  with  a  TI :  of  CO:  (console  output  pseudo 
device).  CLIs  with  conventional  task  names  must  specify  the  TI:  and 
UIC  fields  in  any  RPOI$  or  SPWN$  directives  they  issue,  since  the  the 
TI:  and  UIC  will  not  default  correctly.  Since  there  is  only  one  copy 
of  these  tasks  in  the  system,  CLIs  with  conventional  task  names  can 
simply  stop  rather  than  exiting  when  there  are  no  commands  queued  for 
them.  This  may  be  necessary  if  the  CLI  must  maintain  information  from 
one  command  to  the  next. 

DCL  is  installed  with  a  prototype  task  name,  ...DCL.  RMT  is  installed 
as  RMT...,  with  a  conventional  task  name.  The  difference  reflects  the 
use  and  nature  of  each  CLI. 
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DCL  must  be  installed  with  a  task  name  of  ...DCL  because  most  DCL 
commands  issue  prompts  for  input.  No  command  processing  can  be  done 
by  DCL  while  it  is  waiting  for  the  user  to  respond  to  a  prompt.  If 
there  were  only  one  copy  of  DCL  on  the  system,  command  processing  for 
all  DCL  terminals  would  stop  while  a  prompt  request  to  any  one 
terminal  is  outstanding.  This  is  clearly  not  an  acceptable  situation. 
Giving  each  terminal  its  own  copy  of  DCL  allows  independent  command 
processing  for  each  terminal.  To  avoid  filling  the  system  with  copies 
of  DCL,  the  individual  copies  of  the  task  exit  when  no  commands  are 
left  for  them.  They  can  do  this  since  there  is  no  need  to  maintain 
any  context  between  commands. 

On  the  other  hand,  RMT  is  installed  as  RMT. . •  because  there  can  only 
be  one  copy  of  RMT  in  the  system.  This  is  because  RMT  provides  a 
focal  point  with  which  the  DECnet  command  handling  software  running  on 
the  remote  system  can  communicate.  Furthermore,  it  is  not  practical 
to  have  RMT  exit  when  no  commands  are  outstanding  since  it  is 
necessary  to  maintain  context  between  commands.  If  each  user  got  a 
separate  copy  of  RMT,  the  system  would  be  cluttered  with  copies  of  RMT 
that  did  not  exit. 


11.2.4  MCR  Control  Commands 

The  MCR  CLI  command  is  the  means  by  which  the  system  has  knowledge  of 
CLIs.  The  CLI  command  has  switches  which  perform  such  functions  as 
making  a  CLI  known  to  the  system,  eliminating  it  from  the  system, 
turning  on  and  off  its  recognition  of  commands,  and  so  forth.  See  the 
RSX- 11 M/M- PLUS  MCR  Operations  Manual  for  a  description  of  the  CLI 
command . 


11.2.5  System  Messages  to  CLIs 

Depending  on  the  nature  of  the  CLI,  it  may  be  necessary  for  it  to 
receive  messages  notifying  the  CLI  of  the  occurrence  of  certain  events 
that  could  effect  it.  If  the  /MESSAGE  subkeyword  to  the  CLI  /INIT 
command  is  specified,  it  can  receive  messages  from  the  system 
informing  it  of  such  events.  These  messages  are  returned  by  the  GCCI$ 
directive  just  like  commands.  They  can  be  differentiated  from 
commands  by  the  first  word  of  the  command  buffer  (G.CCDV)  being 
cleared,  instead  of  being  set  up  with  the  name  of  the  device  from 
which  the  command  originated.  The  code  identifying  which  message  is 
present  is  returned  in  the  unit  number  byte  (G.CCUN) .  The  other 
fields  have  the  same  meaning  for  messages  as  they  do  for  commands. 
The  actual  text  field  of  the  buffer  may  be  empty  if  the  message  does 
not  contain  any  ASCII  text.  See  the  RSX-11M/M-PLUS  MCR  Operations 
Manual  for  further  information. 


NOTE 

The  CLI  command  includes  both  a  /MESSAGE 
subkeyword  to  the  /INIT  keyword  and  a 
/MESSAGE  keyword.  The  /MESSAGE 
subkeyword  specifies  that  the  CLI  being 
initialized  can  receive  messages.  The 
/MESSAGE  keyword  sends  an  ASCII  message 
to  a  CLI  that  has  been  initialized  with 
the  /MESSAGE  subkeyword.  See  the 
RSX-1 1 M/M- PLUS  MCR  Operations  Manual  for 
further  information . 
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The  following  sections  describe  the  messages.  Message  codes  1  through 
127.  are  reserved  for  use  by  DIGITAL.  Users  wishing  to  create  their 
own  messages  to  CLIs  should  use  codes  in  the  range  of  128.  through 
255.  The  symbol  shown  for  each  message  code  is  defined  in  the 
Executive  definition  library:  LB : [1 , 1] EXELIB . OLB .  Tasks  may  pick 
them  up  at  build  time  by  linking  with  that  library. 


11.2.5.1  CLI  Initialized  into  an  Enabled  Mode  -  This  message  is  sent 
to  a  CLI  when  it  is  initialized  by  a  CLI  /INIT  command  without 
specifying  the  /DISABLE  switch. 

Message  Code:  1  (CM.INE) 

Text:  CLI  name  in  RAD50 ,  length  =  4  bytes. 


11.2.5.2  CLI  Initialized  into  a  Disabled  Mode  -  This  message  is  sent 
to  a  CLI  when  it  is  initialized  by  a  CLI  /INIT  command  with  the 
/DISABLE  switch. 

Message  Code:  2  (CM.IND) 

Text:  CLI  name  in  RAD50,  length  =  4  bytes. 


11.2.5.3  CLI  Enabled  -  This  message  is  sent  to  the  CLI  when  it  is 
enabled  by  a  CLI  /ENABLE  command. 

Message  Code:  3  (CM.CEN) 

Text:  None. 


11.2.5.4  CLI  Disabled  -  This  message  is  sent  to  the  CLI  when  it  is 
disabled  by  a  CLI  /DISABLE  command. 

Message  Code:  4  (CM. CDS) 

Text:  None. 


11.2.5.5  CLI  Eliminated  -  This  message  is  sent  to  a  CLI  when  it  has 
been  eliminated  by  an  explicit  CLI  /ELIMINATE  command. 

Message  Code:  5  (CM. ELM) 

Text:  None. 
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11.2.5.6  All  CLIs  Eliminated ,  and  must  Exit  -  This  message  is  sent  to 
all  CLIs  on  the  system  which  were  initialized  with  the  /MESSAGE 
subkeyword  to  the  CLI  /INIT  command  when  a  CLI  /ELIM=*  command  is 
issued.  A  CLI  that  receives  this  message  should  exit  as  soon  as 
possible,  since  system  shutdown  or  other  emergency  procedure  is  taking 
place . 

Message  Code:  6  (CM. EXT) 

Text:  None. 


11.2.5.7  Terminal  Linked  to  CLI  -  This  message  is  sent  to  a  CLI  when 
a  terminal  becomes  associated  with  it.  This  message  could  result  from 
a  SET  command  processed  by  MCR,  or  any  other  use  of  the  SCLI$ 
directive. 

Message  Code:  7  (CM.LKT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal,  length  =  4 

bytes.  (2  bytes  each) . 


11.2.5.8  Terminal  Removed  from  CLI  -  This  message  is  sent  to  a 
terminal's  former  CLI  when  it  is  switched  to  another  CLI. 

Message  Code:  8.  (CM.RMT) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal,  length  =  4 

bytes.  (2  bytes  each) . 


11.2.5.9  General  Message  -  This  message  is  the  result  of  a  the  CLI 
/MESSAGE  command.  It  contains  whatever  text  the  issuer  of  the  command 
included  in  the  string,  plus  the  name  and  unit  number  of  the  terminal 
on  which  the  command  was  typed. 

Message  Code:  9.  (CM. MSG) 

Text:  Name  (ASCII)  and  unit  number  (octal)  of  terminal  where  the  CLI 
/MESSAGE  command  originated,  followed  by  the  text  from  the 
command  string.  The  length  is  equal  to  the  length  of  the  string 
(possibly  zero)  plus  the  length  of  the  terminal  name  and  unit 
number  (2  bytes  each) . 


11.2.6  Prompting 

There  are  three  kinds  of  prompts  issued  by  the  system  that  affect 
CLIs: 


1. 

2. 

3. 


CTRL/C  prompts 

Empty  line  prompts  generated  by  solitary  carriage 
Task  exit  prompts 


returns 
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11.2.6.1  CTRL/C  Prompts  -  This  prompt  is  issued  by  the  terminal 
driver  when  it  receives  a  CTRL/C  character.  The  string  to  be  issued 
can  be  specified  when  the  CLI  is  initialized.  There  is  no  way  the  CLI 
can  be  notified  when  this  prompt  is  issued,  however,  since  it  is 
handled  by  the  terminal  driver.  These  prompts  are  of  no  other  concern 
to  CLIs. 


11.2.6.2  Empty-Line  Prompts  -  This  prompt  results  from  terminal  input 
consisting  solely  of  a  carriage-return  character,  which  is  called  a 
null  command  line.  The  standard  system  action  is  to  have  the  MCR... 
task  issue  the  default  prompt,  which  can  be  specified  when  the  CLI  is 
initialized.  The  CLI  can  be  initialized  with  the  /NULL  switch,  which 
causes  the  system  to  send  null  command  lines  to  the  CLI  like  other 
commands,  and  not  output  anything.  Any  prompting  or  other  action  is 
therefore  the  CLI's  responsibility. 


11.2.6.3  Task-Exit  Prompts  -  These  prompts  are  issued  when  a  task 
started  by  a  command  line  exits.  The  standard  system  action  is  to 
have  the  MCR...  task  issue  the  same  default  prompt  string  as  in  the 
case  of  an  empty  line.  If  the  CLI  wishes  to  be  informed  of  these 
occurrences,  it  can  be  initialized  with  the  /PROMPT  switch,  which 
causes  the  system  to  send  these  task  exit  prompt  requests  to  the  CLI 
without  terminal  output.  Any  prompting  or  other  action  is  then  the 
CLI's  responsibility. 

On  RSX-11M-PLUS  systems,  a  CLI  initialized  to  receive  either 
empty-line  or  task-exit  prompts  has  to  issue  an  SNXC$  directive  when 
its  processing  of  the  prompt  is  complete.  SNXC$  tells  the  terminal 
driver  that  the  current  command  is  complete,  and  it  can  send  the  next 
one  if  the  terminal  is  in  serial  processing  mode.  This  directive  can 
be  issued  if  the  terminal  is  not  in  serial  mode  without  any  adverse 
effects.  See  Section  11.2.6,  Serial  Command  Processing,  for  further 
details . 


11.2.7  System  Handling  of  Continuation  Lines 


Continuation  lines  are  handled  by  the  RSX-11M-PLUS  terminal  driver 
before  the  command  is  passed  to  the  CLI.  Incomplete  segments  of 
command  lines  are  detected  by  the  presence  of  a  hyphen  as  the 
character  immediately  preceding  the  terminator.  Any  hyphens  are 
removed  and  all  the  pieces  of  the  command  put  together  before  the  CLI 
is  aware  of  the  command,  so  the  CLI  does  not  have  to  deal  with 
continuation  lines  in  any  way.  If  the  CLI  does  not  want  the  system  to 
interpret  the  presence  of  the  hyphen  as  denoting  a  continuation  line, 
it  can  be  initialized  with  the  /SNGL  switch.  This  tells  the  system  to 
accept  single  line  commands  only,  and  pass  every  line  to  the  CLI  as  it 
is  entered.  No  continuation  line  checks  are  made. 

The  DCL  CLI  on  RSX-11M  does  its  own  handling  of  continuation  lines. 
This  is  done  within  DCL  itself,  and  is  not  available  as  a  general 
system  feature.  This  option  is  open  to  CLIs  on  RSX-11M  systems,  but 
is  not  necessary  for  CLIs  on  RSX-11M-PLUS  as  the  system  puts  all  the 
segments  together  before  the  command  is  sent  to  the  CLI. 
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11.2.8  Interaction  with  Serial  Command  Processing  (RSX-11M-PLUS  only) 

Serial  command  processing  is  a  mode  in  which  commands  from  a  terminal 
are  executed  in  sequential  order,  with  a  command  not  being  started 
until  the  preceding  command  is  finished.  The  default  for  command  line 
processing  on  RSX-11M-PLUS  systems  is  parallel  processing,  but  a  CLI 
may  need  to  synchronize  commands.  Command  synchronization  is  achieved 
by  having  the  terminal  driver  store  characters  in  the  typeahead  buffer 
if  they  are  entered  while  a  command  is  outstanding  on  that  terminal. 
These  characters  are  issued  as  the  next  command  by  a  special  call  to 
the  terminal  driver  at  the  completion  of  the  processing  of  the  current 
command.  This  command  completion  is  normally  signalled  to  the  system 
by  the  exiting  of  the  final  task  involved  in  the  processing  of  the 
command . 

If  a  task  -  either  the  CLI  or  a  task  chained  to  by  RPOI$  or  SDRP$  - 
exits  at  the  completion  of  command  execution  and  no  prompt  request  is 
generated  (meaning  the  command  was  terminated  by  an  ESCAPE  character) , 
the  terminal  driver  is  called  directly  from  the  task  exit  code  in  the 
Executive.  If  a  task  exit  prompt  request  is  generated,  the  terminal 
driver  has  to  be  called  at  the  completion  of  the  prompt  request 
processing.  If  the  CLI  is  not  receiving  prompt  requests,  the  terminal 
driver  call  is  done  automatically  by  the  system,  and  the  CLI  need 
never  get  involved. 

If  the  CLI  has  been  initialized  to  receive  prompt  requests,  the  system 
passes  the  prompt  request  on  to  the  CLI  like  any  other  command.  It 
becomes  the  CLI ' s  responsibility  to  write  any  prompt  string  to  the 
terminal  and  call  the  terminal  driver  to  initiate  the  next  command. 
The  CLI  should  therefore  issue  an  SNXC$  directive  at  the  completion  of 
its  processing  of  the  prompt  request. 

If  no  task  exit  will  occur  to  terminate  the  command  execution,  the 
system  has  no  way  of  knowing  when  the  command  is  complete.  Therefore 
the  SNXC$  directive  must  be  used  to  mark  the  end  of  the  command  and 
cause  the  next  one  to  be  initiated.  Issuing  this  directive  causes  a 
task  exit  prompt  request  to  be  generated  if  one  would  have  been 
generated  by  a  task  exit.  If  no  prompt  request  is  generated,  SNXC$ 
calls  the  terminal  driver  to  send  the  next  command  to  the  system  for 
processing.  This  directive  can  be  issued  by  the  CLI  or  the  final  task 
chained  to  by  means  of  an  RPOI$  or  SDRP$  directive. 

It  is  not  necessary  for  applications  using  the  SNXC$  directive  to 
check  if  a  terminal  is  actually  in  serial  mode.  If  the  terminal  is 
not  in  serial  mode,  the  terminal  driver  sends  commands  to  the  system 
as  they  are  entered.  The  directive  does  not  cause  the  terminal  driver 
to  be  called  since  it  is  not  necessary.  The  terminal  driver  still 
generates  a  task  exit  prompt  request  if  one  would  have  been  generated 
when  the  task  exited.  The  issuance  of  this  directive  clears  the 
status  bits  that  tell  the  system  to  generate  a  prompt  request  or  call 
the  terminal  driver  at  task  exit.  Therefore  a  task  exiting  after 
issuing  an  SNXC$  directive  does  not  cause  two  prompt  requests  to  be 
issued . 

See  the  RSX-11M/M-PLUS  Executive  Reference  Manual  for  more  information 
on  the  SNXC$  directive. 
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11.3  SIMPLE  SAMPLE  CLI 

Here  is  a  sample  CLI,  written  in  both  MACRO-11  and  FORTRAN.  The  same 
programs  are  included  on  your  system  kit  as  TMCLI . MAC  or  TMCLI.FTN. 
This  CLI  is  as  simple  as  possible  to  illustrate  what  is  necessary  to 
construct  a  CLI.  All  TMCLI  does  is  receive  commands  and  pass  them  to 
MCR  for  execution.  A  user  of  this  CLI  may  not  even  be  aware  that  it 
is  there  as  there  is  no  apparent  difference  from  being  an  MCR 
terminal.  The  only  additional  capabilities  TMCLI  offers  are  two 
single-letter  commands,  T  to  type  a  file,  or  M  to  switch  back  to  MCR 
mode.  The  comments  in  the  listing  suggest  several  simple 
modifications  that  can  be  made  to  illustrate  the  options  available 
when  designing  or  setting  up  a  CLI. 


11.3.1  MACRO-11  CLI 

♦TITLE  TMCLI  -  EXAMPLE  CLI  THAT  IMPLEMENTS  'T*  AND  *M’  COMMAND 
♦ IDENT  /1.00/ 

THIS  TASK  (TMCLI)  ILLUSTRATES  THE  USE  OF  THE  CLI  CONTROL  DIRECTIVES  OF 
RSX-11M  V4.0  AND  RSX-llM-F'LUS  V2.0. 

WHEN  SET  UP  AS  A  TERMINAL'S  CLI,  IT  PROVIDES  THE  FOLLOWING  COMMANDS  1 

T  ->  TYPE  FILE 

M  ->  SET  TERMINAL  TO  MCR 

IF  THE  FIRST  TWO  LETTERS  OF  THE  COMMAND  ARE  NOT  ‘T*  FOLLOWED 
BY  A  SPACE  »  OR  ’M’  FOLLOWED  BY  A  CARRIAGE  RETURN , 

THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION.  THEREFORE, 

USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 
AS  BEING  PRESENT,  PLUS  THE  ‘T1  AND  ’M*  COMMANDS.  IF  THE  /DPR  SUBKEYWORD 
IS  INCLUDED  ON  THE  CLI  /INIT  COMMAND,  USERS  WILL  KNOW  IMMEDIATELY  IF 
THEIR  TERMINAL  IS  SET  TO  THIS  CLI  BY  THE  DOUBLE  RIGHT  ANGLE  BRACKET  PROMPT. 

IF  TMCLI  IS  INITIALIZED  WITH  THE  /MESSAGE  KEYWORD,  TMCLI  WILL 
GREET  USERS  WHEN  THEIR  TERMINAL  IS  SET  TO  THE  CLI,  AND  SAY  GOODBYE 
TO  THEM  WHEN  THEY  SWITCH  AWAY. 

IN  ORDER  TO  BRING  THIS  CLI  UP  ON  THE  SYSTEM,  ISSUE  THE  FOLIOWING 
COMMAND  SEQUENCE  * 

>MAC  TMCLI, TMCLI/-SP=TMCLI 

>TKB  TMCLI,TMCLI/-SP=TMCLI , Cl , 1IEXELIB/LB 

>INS  TMCL I/CL I=YES/T ASK= . . ,TMC 

•>CLI  /INIT=TMCLI/MESSAGE/DPR=,<15X12>/>>/,/TASK=.  ,  ,TMC 

TO  SET  TERMINALS  TO  THIS  CLI,  ISSUE  THE  FOLLOWING  COMMAND 
WHERE  TTNN5  IS  REPLACED  BY  THE  TERMINAL  NUMBER  OR  TI{ 

>SET  /cli=ttnn:tmcli 

NOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROL/C  DEFAULTS  TO  THE 
NAME  OF  THE  CLI,  WHICH  IS  ■TMCLI>,( 

TMCLI  CAN  BE  ELIMINATED  FROM  THE  SYSTEM  BY  THE  FOLLOWING  COMMANDS,  ASSUMING 
NO  TERMINALS  ARE  SET  TO  ITS 

>CLI  /ELIM=TMCLI 
>REM  . . . TMC 
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i  EXPERIMENT  WITH  THE  OTHER  SUBKEYWORDS  OF  THE  CLI  /INIT  COMMAND .  THE  CLI 
i  /ENABLE  AND  CLI  /DISABLE  COMMANDS >  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 
»  COMMAND  TO  OBSERVE  THE  EFFECTS.  ALSO  TRY  CHANCING  THE  /TASK= 

;  SWITCH  ON  THE  INS  AND  CLI  /INIT  COMMAND  TO  * /T ASK=TMCL I "  AND  NOTICE 
5  THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS  r  RATHER  THAN 
)  ONE  PER  COMMAND.  IF  YOU  DO  THIS.  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 
i  ON  THE  GCCI*  DIRECTIVE  FROM  GC.CEX  TO  GC.CST  SO  THE  TASK  WILL  STAY  ACTIVE 
;  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 


. MCALL  GCCI*.RPOI*»EXIT$S.QIOW*.ALUN*.DIR* 


DIRECTIVE  DPBS 


9 

gcci: 

GCCI  % 

CMDBUF»CBLEN>IBUF»IBLENjO>GC*CEX 

rpoi  : 

R  P  0 1  $ 

MCR* ♦ ♦ 

qiow: 

QIOW$ 

I0«UVB>5>1>  9 9  9 <  » >40  > 

alun: 

ALUN$ 

5 

i  BUFFER  AREAS 

CMDBUFJ  .BLKB  8O.+G.CCBF  {LENGTH  =  HEADER  PLUS  COMMAND  IN  BYTES 

{  NOTE  THAT  ON  M-F'LUS  THE  MAXIMUM  COMMAND 
.LENGTH  IS  255.  BYTES.  SO  THE  LENGTH  SHOULD 
i BE  <255 . +G . CCBF>  OR  CHARACTERS  MAY  BE  LOST. 


CBLEN=.-CMDBUF 

.EVEN 


> CALCULATE  LENGTH 


IBUF5  .BLKB  G.CCCA+2 
I BLEN= , - IBUF 
.EVEN 


.LONG  ENOUGH  TO  CONTAIN  ALL  INFORMATION 
.CALCULATE  LENGTH 


TCMD5  .ASCII  /PIP  T I  *  =/ 

TCLEN= . -TCMD 

BUF:  .BLKB  80.-TCLEN 

.EVEN 


‘.BASIC  PIP  COMMAND  TO  IMPLEMENT  *T*  COMMAND 

{ LENGTH  OF  COMMAND 

.BUFFER  TO  GENERATE  COMMANDS  IN 


MCRJ  .ASCII 

mcmd:  .ascii 

MCLEN= . -MCMD 
.EVEN 


/M/<15>  » STRING  TO  RECOGNIZE  AS  A  SET  TO  MCR  REQUEST 

XSET  /MCR  =  TI I  X  » SET  TERMINAL  TO  MCR  COMMAND 
{LENGTH  OF  COMMAND 


\  TEXT  TO  BE  DISPLAYED  UPON  RECEIPT  OF  NEW  TERMINAL-LINKED  OR 
{  TERMINAL-REMOVED  MESSAGES  FROM  SYSTEM. 

LKTi  .ASCII  <15X12 > /WELCOME  TO  THE  EXAMPLE  CLI/<15><12> 
LKTLEN= . -LKT 
.EVEN 

RMTS  .ASCII  <15><12>/G00D  BYE  FROM  THE  EXAMPLE  CLI/<15><12> 
RMTLEN= . -RMT 
.EVEN 


{  MESSAGE  FOR  CHARACTERS  LOST  DUE  TO  BUFFER  BEING  TOO  SMALL 

CHLOST:  .ASCII  <15><12>/S0RRY »  PART  OF  YOUR  COMMAND  WAS  L0ST/<15><12> 
CLLEN= . -CHLOST 
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»  ILLEGAL  COMMAND  MESSAGE 

9 

ILL!  .ASCII  <15><12>/ILLEGAL  COMM  AND /<15X12> 
ILLLEN= . -ILL 
.  EVEN 


CL  I  CODE 


start: 


. ENABL  LSD 
DIR*  *GCCI 

DCS  100* 


i GET  A  COMMAND  FROM  SYSTEM 
J  IF  CS,  DIRECTIVE  ERROR 


IF  THE  GCCI*  DIRECTIVE  HAD  THE  GC.CST  OPTION  SPECIFIED.  WE  MAY  HAVE 
JUST  BEEN  UNSTOPPED.  SO  WE  HAVE  TO  GET  THE  COMMAND. 


CMP 

BEQ 

MOV 

TST 

BEQ 

CMPB 

BLO 

MOV 


♦IS.CLR.tDSW 

START 

♦CMDBUF.RO 
<  RO ) 

MSG 


» WERE  WE  JUST  UNSTOPPED? 
JIF  EQ  YES 

» POINT  TO  COMMAND  BUFFER 
ilS  THIS  A  SYSTEM  MESSAGE? 
HF  EQ  YES 


G.CCCT(RO) »G.CCCL<RO)  .DID  ENTIRE  COMMAND  FIT  IN  BUFFER 
150*  SIF  LO  NO 

♦  RP0I.R5  .POINT  TO  DF'B  OF  RPOI*  DIRECTIVE 


AT  THIS  POINT.  THE  CLI  HAS  A  COMMAND  TO  BE  PROCESSED.  THE  CODE  FROM 
THE  ‘START? 1  LABEL  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  ALL  CLIS. 

FROM  THIS  POINT  ON.  THE  CODE  WILL  BE  SPECIFIC  TO  THE  PARTICULAR  LANGUAGE 
THIS  CLI  IS  IMPLEMENTING.  COMMANDS  CAN  BE  ADDED  OR  DELETED  AT  WILL 
BY  MODIFYING  CODE  IN  THIS  SECTION.  AS  STATED  ABOVE.  THIS  EXTREMELY 
SIMPLE  CLI  PROVIDES  TWO  COMMANDS.  AND  GIVES  EVERYTHING  ELSE  TO  MCR. 

THIS  CREATES  AN  OPEN  ENDED  ENVIRONMENT.  REJECTING  UNRECOGNIZED  COMMANDS 
INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THE  TERMINAL  USER'S  USE  OF 
THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  BY  THE  CLI.  THIS  IS 

?uStuVoE.tv*L?£  CONTROLLING  SYSTEM  USE,  IN  CASES  WHEN  IT  IS  NECESSARY. 

IN  THIS  EXAMPLE.  CHANGING  THE  * BNE  50*‘  BELOW,  TO  A  *BNE  60*‘ 

WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USER  COULD 
PERFORM  WOULD  BE  TO  TYPE  FILES  ON  THE  TERMINAL,  OR  SWITCH  BACK  TO  MCR. 
ALL  OF  THE  REST  OF  THE  SYSTEM  IS  INACCESSIBLE.  IF  NO  MEANS  OF  SWITCHING 
BACK  TO  MCR  IS  PROVIDED.  IT  IS  IMPOSSIBLE  FOR  THE  USER  TO  DO 
ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO. 


CMP  * ‘ T  .G.CCBF(RO)  JIS  IT  A  ‘T‘  COMMAND? 

BEQ  10*  } IF  EQ  YES 

CMP  MCR » G • CCBF ( RO )  }IS  IT  AN  ‘M‘  COMMAND? 


CHANGE  THE  NEXT  INSTRUCTION  TO  ‘BNE  60*‘ 
COMMANDS  TO  MCR. 

BNE  50*  ? IF  NE  NO 


TO  ELIMINATE  PASSING  UNKNOWN 
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9 

THE 

USER  HAS 

ENTERED  AN  "M" 

COMMAND  9  SO  SET  THE  TERMINAL  TO  MCR* 

MOV 

#MCMD , R . F'OBF < R5  )  JPUT  ADDRESS  OF  CMD  TO  ISSUE  IN 

DPB 

MOV 

*MCLEN,R.P0BL(R5)  SPUT  LENGTH  OF  CMD  IN  DPB 

BR 

ISSCMD 

5  ISSUE  COMMAND 

9 

9 

THE 

USER  HAS 

ENTERED  A  BT' 

COMMAND  SO  CONSTRUCT  THE  NECESSARY  PIP 

9 

9 

COMMAND  AND 

SEND  IT  TO  MCR ♦ 

io$: 

MOV 

RO  9  R1 

JCOPY  ADDRESS  OF  BUFFER  WITH  COMMAND 

ADD 

♦G*CCBF+1 ,R1 

j POINT  TO  SPACE  AFTER  THE  T 

MOV 

♦BUF,R2 

» POINT  TO  BUFFER  THAT  WILL  CONTAIN 

CMD 

MOV 

♦  TCLEN  9 R4 

> GET  LENGTH  OF  INITIAL  PART  OF  COMMAND 

20$: 

MOVB 

(  R 1  )  +  >  R  3 

f GET  NEXT  CHARACTER 

CMPB 

♦  1 5  f  R3 

9  IS  IT  THE  END  OF  THE  COMMAND 

BEQ 

30$ 

5  IF  EQ  YES 

CMPB 

♦  40  f  R3 

9  IS  IT  A  SPACE 

BEQ 

20$ 

ilF  EQ  YES  >  SKIP  IT 

MOVB 

R  3  »  (  R  2  )  P 

?  PUT  CHARACTER  IN  OUTPUT  BUFFER 

INC 

R4 

9  COUNT  CHARACTER 

BR 

20$ 

f  GET  NEXT  CHARACTER 

30$: 

MOV 

*TCHD,R.P0BF(R5) JPUT  ADDRESS  OF  ChD  TO  ISSUE  IN  DP 

B 

MOV 

R4fR*P0BL(R5) 

f INSERT  LENGTH  OF  COMMAND 

THIS 

COMMAND 

WILL  BE  PASSED 

TO  THE  MAIN  COMMAND  DISPATCHER  (MCR* 

♦  *  )  9 

WHICH  WILL  START  A  COPY  OF 

PIP  AND  GIVE  IT  THE  COMMAND*  THE  RPOI 

DIRECTIVE  COULD  BE  USED  TO  GIVE  THE  COMMAND  DIRECTLY  TO  ...PIP  AND 
GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME.  IN  THIS  EXAMPLE, 

HE  COULD  CALL  THE  RESULTING  PIP  TASK  '  T YF'TNN '  WHERE  THE  LAST 
THREE  CHARACTERS  ( TNN )  ARE  REPLACED  BY  A  DEVICE  NAME  CHARACTER  AND 
UNIT  NUMBER.  FOR  EXAMPLE,  IF  THE  ,T*  COMMAND  WAS  TYPED  ON  TTIOS 
THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  "TYPTIO*.  THIS  HAS  THE 
ADVANTAGE  OF  ALLOWING  THE  TASK  TO  BE  ABORTED  BY  AN  ‘ABO  TYP ■  COMMAND, 
INSTEAD  OF  'ABO  PIP’,  THUS  THE  USER  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 
•T*  COMMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED  BY  THE  PIP  TASK.  THIS 
IS  EXACTLY  WHAT  THE  DCL  CLI  DOES.  IT  IS  NOT  DONE  HERE 
TO  SIMPLIFY  THE  EXAMPLE.  PICKING  UP  THE  TERMINAL  NAME  AND  UNIT 
NUMBER,  CONVERTING  IT  TO  RAD50 ,  AND  SUPPLYING  IT  IN  THE  RPOI  DIRECTIVE 
ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN  EXERCISE  TO  THE  USER. 
(BE  CAREFUL  ON  RSX-llM-F'LUS  SYSTEMS  WITH  MORE  THAN  64.  TERMINALS). 

NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL  AMOUNT  OF  SYSTEM 
OVERHEAD. 

BR  ISSCMD  J EXECUTE  COMMAND 


»  COMMAND  IS  NOT  ' T *  OR  *M* ,  SO  GIVE  IT  TO  MCR  AS  IS. 
f 

50$:  MOV  ♦CMDBUF+G*CCBF,R*P0BF(R5>  iPUT  ADDRESS  OF  STRING  IN  DPB 

MOVB  G ♦ CCCT (RO) >R*P0BL(R5)  9  PUT  LENGTH  IN  RPOI  DPB 


ISSUE  R  P  0 1  $  DIRECTIVE  TO  EXECUTE  COMMAND 


ISSCMD •  MOV 
MOVB 
MOVB 
MOVB 
MOV 
DIR$ 
BCC 
BR 


(RO) »R*P0DV(R5)  ?  PUT  NAME  OF  ISSUING  DEVICE  IN  RPOI 
G ♦ CCUN ( RO ) ?  R • POUN ( R5 )  r COPY  UNIT  NUMBER 
IBUF+G*CCPU»R*P0UM(R5)  > PROPAGATE  UIC  OF  TERMINAL 
IBUF+G.CCPU+1 *R*P0UG(R5) 

IBUF+G*CC0AjR«P00A(R5)  *COPY  ID  PARENT  IN  CASE  WE 
♦  RPOI  ? PASS  COMMAND  TO  EXECUTOR  TASK 

START  > I F  CCf  SUCCESS 

110$  f ERROR 


WERE  SPAWNED 
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CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  COMMANDS  ARE  TO  BE  REJECTED 
INSTEAD  OF  BEINO  PASSED  TO  MCR . 


60$ « 

MOO 

#  I L  L  f  R 1 

fPOINT 

TO  MESSAGE  TO  BE 

MOO 

# ILLLEN  r R2 

r GET  LENGTH  OF  MESSAGE 

CALL 

ISSMSG 

9  ISSUE 

MESSAGE 

BR 

START 

;try  for  next  command 

f 

f  ERROR 

F 

HANDLING 

i  CODE 

ioo$: 

CLR 

RO 

f  FATAL 

ERROR  ON  GCC 1 $ 

BR 

150$ 

110$: 

MOO 

♦  1  f  R  0 

f  FATAL 

ERROR  ON  R P 0 1 $ 

120$: 

IOT 

5  FAT AL 

150$: 

MOO 

♦  CHLQST  9 R 1 

fPOINT 

TO  MESSAGE  TO  BE 

MOO 

♦  CLLEN  9 R2 

>  GET  LENGTH  OF  MESSAGE 

CALL 

ISSMSG 

fISSUE 

MESSAGE 

BR 

START 

♦  DSABL 

LSB 

A  SYSTEM  MESSAGE  WAS  RECEIVED  INSTEAD  OF  A  COMMAND. 


msg: 

CMPB 

♦CM.LKTfG. 

CCUN(RO)  fIS  IT  A  NEW  TERMINAL  LINKED  TO  US? 

BEQ 

10$ 

fIF  eq  YES 

CMPB 

♦CM.RMTfG. 

CCUN(RO)  fIS  IT  A  TERMINAL  BEING  REMOOED 

BEQ 

20$ 

fIF  EQ  YES 

CMPB 

♦CM.EXTfG. 

CCUN(RO)  fIS  IT  AN  ELIMINATE  ALL  PACKET 

BEQ 

50$ 

fIF  EQ  YES 

CMPB 

#CM*ELMfG. 

CCUN(RO)  fIS  IT  A  CLI  ELIMINATION  MESSAGE 

BEQ 

50$ 

fIF  EQ  YES 

BR 

START 

fIGNORE  ALL  OTHER  MESSAGES 

F 

9  ISSUE 

WELCOME 

MESSAGE 

io$: 

MOO 

♦LKTfRI 

f  P 0 1 N T  TO  MESSAGE  TEXT 

MOO 

♦  LKTLEN  f  R2 

f  GET  LENGTH 

ADD 

♦G.CCBFfRO 

fPOINT  TO  TERMINAL  THAT  WAS  SET 

BR 

30$ 

F 

9 

i  ISSUE 

GOODBYE 

MESSAGE 

F 

20$: 

MOO 

♦RMTfRI 

fPOINT  TO  MESSAGE  TEXT 

MOO 

♦RMTLEN  f  R2 

f  GET  LENGTH 

ADD 

#G*CCBFfRO 

fPOINT  TO  TERMINAL  NAME 

30$: 

CALL 

ISSMSG 

f ISSUE  MESSAGE 

JMP 

START 

f  GET  NEXT  COMMAND 

F  WHEN 

AN  ELIMINATE  ALL  MESSAGE  IS  RECEIVED.  EXIT  IMMEDIATELY. 

50$: 

EXI T$S 
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ROUTINE  TO  PRINT 


TO  TERMINAL 


INPUTS} 


}  RO-ADDRESS  OF  NAME  OF  TERMINAL  TO  PRINT  TO 

}  R1=ADDRESS  OF  MESSAGE  TO  PRINT 

i  R2=LENGTH  OF  MESSAGE 

*  OUTPUTS} 


NONE 


*  THIS  ROUTINE  PRINTS  THE  SPECIFIED  MESSAGE  ON  THE  SPECIFIED  TERMINAL. 
}  ALL  ERRORS  THAT  MIGHT  RESULT  ARE  IGNORED.  IN  GENERAL*  CLIS  SHOULD 

*  DO  ASYNCHRONOUS  I/O  WITH  COMPLETION  ASTS*  AND  PROVIDE  A  TIME-OUT 
J  FACILITY  TO  KILL  THE  I/O  IF  IT  HASN'T  COMPLETED  IN  A  CERTAIN 

i  AMOUNT  OF  TIME.  THIS  PREVENTS  TERMINAL  I/O  FROM  HOLDING  UP 
}  COMMAND  PROCESSING.  THIS  IS  NOT  DONE  HERE  FOR  SIMPLICITY. 


ISSMSG} 


lot; 


MOV 

MOVB 

CLRB 

DIR* 

DCS 

MOV 

MOV 

DIR* 

RETURN 

.END 


(RO) fALUN  +  A.LUNA  * SET  UP  DEVICE  NAME 
2(R0>  fALUN+A.LUNU  SAND  UNIT  NUMBER 
ALUN+A . LUNU+ 1  SCLEAR  HIGH  BYTE 

♦  ALUN  S ASSIGN  LUN  5  TO  THE  SPECIFIED  DEVICE 

10*  SIF  CS*  SKIP  I/O 

R1 fQIOU+Q. IOPL  SSET  ADDRESS  OF  MESSAGE 
R2» QIOW+G.  IOPL  +  2  SINSERT  LENGTH  OF  MESSAGE 

♦  QIOW  S DO  I/O  AND  WAIT  FOR  IT 


START 


11.3.2  FORTRAN  CLI 


THIS  TASK  <  TMCLI )  ILLUSTRATES  THE  USE  OF  THE  CLI  CONTROL  DIRECTIVES  OF 
RSX-11M  V4.0  AND  RSX-UM-PLUS  V2.0. 

WHEN  SET  UP  AS  A  TERMINAL'S  CLI >  IT  PROVIDES  THE  FOLLOWING  COMMANDS! 


->  TYPE  FILE 

->  SET  TERMINAL  TO  MCR 


IF  THE  FIRST  TWO  LETTERS  OF  THE  COMMAND  ARE  NOT  ’T*  FOLLOWED 
BY  A  SPACE  *  OR  ’M*  FOLLOWED  BY  A  CARRIAGE  RETURN* 

THE  COMMAND  IS  PASSED  TO  MCR  FOR  EXECUTION.  THEREFORE  * 

USERS  AT  TERMINALS  SET  TO  THIS  CLI  WILL  SEE  THE  ENTIRE  MCR  COMMAND  SET 
AS  BEING  PRESENT*  PLUS  THE  * T *  AND  ‘M1  COMMANDS.  IF  THE  /DPR  SUBKEYWORD 
IS  INCLUDED  ON  THE  CLI  /INIT  COMMAND*  USERS  WILL  KNOW  IMMEDIATELY  IF 
THEIR  TERMINAL  IS  SET  TO  THIS  CLI  BY  THE  DOUBLE  RIGHT  ANGLE  BRACKET  PROMPT. 
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C  IF  TMCLI  IS  INITIALIZED  WITH  THE  /MESSAGE  KEYWORD?  TMCLI  WILL 
C  GREET  USERS  WHEN  THEIR  TERMINAL  IS  SET  TO  THE  CLI?  AND  SAY  GOODBYE 
C  TO  THEM  WHEN  THEY  SWITCH  AWAY ♦ 

C 

C  IN  ORDER  TO  BRING  THIS  CLI  UP  ON  THE  SYSTEM?  ISSUE  THE  FOLLOWING 
C  COMMAND  SEQUENCE: 

C 

C  > F 0 R  TMCLI ?TMCLI/-SP=TMCLI 

C  >TKB  TMCLI/FP?TMCLI/~SP=TMCLI?Cl?13FOROTS/LB 
C  > I N S  TMCL I /CL  I  =  YES/TASK= ♦ • *TMC 

C  >CL  I  /INI  T  =  TMCL  1/ MESSAGE /DP  R  =  "<  15X1 2>/>>  /  1  /  TASK  =♦  ♦  *TMC 
C 

C  IF  USING  FORTRAN  IV-PLUS  INSTEAD  OF  FORTRAN  IV?  THE  FIRST  TWO 
C  COMMANDS  ABOVE  WOULD  BE: 

C 

C  >F4P  TMCLI?TMCLI/-SP=TMCLI*FTN 

C  >TKB  TMCLI/FP?TMCLI/-SP  =  TMCLI ?  Cl ? 13F4 POTS/LB 

C 

C  TO  SET  TERMINALS  TO  THIS  CLI?  ISSUE  THE  FOLLOWING  COMMAND 
C  WHERE  TTNNt  IS  REPLACED  BY  THE  TERMINAL  NUMBER  OR  TI S 
C 

c  >set  /cli=ttnn:tmcli 

C 

C  NOTE  THAT  THE  PROMPT  ISSUED  IN  RESPONSE  TO  A  CONTROL/C  DEFAULTS  TO  THE 
C  NAME  OF  THE  CLI?  WHICH  IS  " TMCLI>  * ♦ 

C 

C  TMCLI  CAN  BE  ELIMINATED  FROM  THE  SYSTEM  BY  THE  FOLLOWING  COMMANDS?  ASSUMING 
C  NO  TERMINALS  ARE  SET  TO  IT: 

C 

C  >CLI  /ELIM=TMCLI 
C  >REM  . ♦ *TMC 
C 

C  EXPERIMENT  WITH  THE  OTHER  SUBKEYWORDS  OF  THE  CLI  /INIT  COMMAND?  THE  CLI 
C  /ENABLE  AND  CLI  /DISABLE  COMMANDS?  AND  WITH  THE  /MESSAGE  SWITCH  ON  THE  /INIT 
C  COMMAND  TO  OBSERVE  THE  EFFECTS ♦  ALSO  TRY  CHANGING  THE  /TASK= 

C  SWITCH  ON  THE  INS  AND  CLI  /INIT  COMMAND  TO  " /T ASK  =  TMCL I '  AND  NOTICE 
C  THAT  ONLY  ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALS?  RATHER  THAN 
C  ONE  PER  COMMAND ♦  IF  YOU  DO  THIS?  YOU  SHOULD  ALSO  CHANGE  THE  OPTION 
C  ON  THE  GTCMCI  DIRECTIVE  FROM  GC*CEX  TO  GC*CST  SO  THE  TASK  WILL  STAY  ACTIVE 
C  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT* 

C 

C 

C  BUFFER  AREAS 
C 

C  COMMAND  BUFFER  -  THIS  BUFFER  IS  USED  IN  THE  GTCMCI  DIRECTIVE*  IT  CON- 
C  TAINS  INFORMATION  ON  THE  COMMAND  RECEIVED  (8  BYTES) 

C  AND  THE  COMMAND  TEXT* 

BYTE  CMDBUF ( 264 ) 

INTEGER*2  CBLEN  !  NOTE  THAT  ON  M+  THE  MAXIMUM  COMMAND 

DATA  CBLEN/263/  !  LENGTH  IS  255* 

INTEGER*2  GCCDV?  GCCCL  !  ASCII  DEV  NAM?  ♦  CHARS  IN  CMD  LINE 

BYTE  GCCCT  ?  GCCUN?  GCCBF<255>  !  ♦  OF  CHARS?  TERMINAL  UNIT  *?  CMD 
EQUIVALENCE  ( GCCDV ? CMDBUF ) ?  ( GCCCL ? CMDBUF < 5 ) ) ?  ( GCCCT ? CMDBUF ( 4 ) ) ? 

1  (GCCBF?CMDBUF(9) ) ?  ( GCCUN ? CMDBUF ( 3  )  ) 

C 
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INFORMATION  BUFFER  -  ALSO  RETURNED  IN  THE  GTCMCI  DIRECTIVE. 

BYTE  IBUF (14) 

INTEGER*2  GCCPU 

DATA  IBLEN/14/f GCCPU/9/  !  LENGTH  OF  IBUF»  LOGIN  UIC  OFFSET 
INTEGERM  GCCOA  !  ADDR  OF  OFFSPRING  CONTROL  BLOCK  FROM  PARENT 

EQUIVALENCE  ( GCCOA » IBUF ( 7 ) ) 

BUFFER  IN  WHICH  TO  GENERATE  COMMANDS 

BYTE  BUF ( 72 )  !  BUFFER  IN  WHICH  TO  GENERATE  COMMANDS 

REAL*8  TCMD  <  2 )  !  FOR  CONVENIENCE  IN  ASSIGNMENT  STATEMENTS 

EQUIVALENCE  <  BUF  *  TCMD ) 

MCR  TASK  NAME  IN  RAD50 

INTEGER*-*  I  MCR  !  MCR  TASK  NAME  IN  RAD50 

DATA  IMCR/6RMCR. . ./ 

DIRECTIVE  SYMBOLIC  VALUE  DEFINITIONS 

INTEGER*2  GCCCSt  GCCEXf  GCCST>  GCCND 

DATA  GCCCS  t  GCCEXr  GCCST f  GCCND  /Of  lr  2i  128/  !  INCP  VALUES  IN  GTCMCI 

DATA  ISCLR  /O/  !  IS.CLR  RETURN  CODE 

INTEGER*2  CMELM  ?  CMEXT  t  CMLKT  t  CMRMT  !  TERMINAL  CODES  FOR  SYSTEM  MSGS 
DATA  CMELM f  CMEXT  t  CMLKT  *  CMRMT  /5f  6r  7,  8/ 

CLI  CODE 


TO  FORCE  THE  CLI  TO  EXIT  INSTEAD  OF  RETURNING f  THE  GC.CEX  OPTION  IS  SPECI¬ 
FIED  IN  THE  GTCMCI  DIRECTIVE  BELOW.  IF  THE  CLI  IS  INSTALLED  SO  THAT  ONLY 
ONE  COPY  OF  THE  TASK  WILL  EXIST  FOR  ALL  TERMINALSr  CHANGE  THE  VARIABLE 
GCCEX  BELOW  TO  GCCST.  THIS  SPECIFIES  THE  GC.CST  OPTION  SO  THAT  THE  TASK- 
WILL  STAY  ACTIVE  BUT  STOPPED  WHEN  NO  COMMANDS  ARE  OUTSTANDING  FOR  IT. 

1  CALL  GTCMCI ( CMDBUF  ?  CBLEN » IBUF  » I BLEN  f  0  f  GCCEX  t IDS )  !  GET  CMD  FOR  CLI 
IF  < I DS  .LT.  0)  GO  TO  100 

IF  THE  GTCMCI  DIRECTIVE  HAD  THE  GC.CST  OPTION  SPECIFIED*  WE  MAY  HAVE 
JUST  BEEN  UNSTOPPED f  SO  WE  HAVE  TO  GET  THE  COMMAND. 


IF  (IDS  .EQ.  ISCLR)  GO  TO  1 
IF  (GCCDV  .EQ.  0)  GO  TO  200 


!  WERE  WE  JUST  UNSTOPPED? 

!  IS  THIS  A  SYSTEM  MESSAGE? 


IGCCUN  =  GCCUN  !  CONVERT  BYTE  TO  INTEGER  (UNIT  *) 

CALL  ASNLUN(5r GCCDVf IGCCUNf IDS)  !  ASSIGN  TERMINAL  TO  LUN  5 
IGCCCT=GCCCT  !  CONVERT  BYTE  TO  INTEGER 

IF  (IGCCCT  . GE.  0)  GO  TO  5 

IGCCCT  =  256  +  IGCCCT  !  CONVERT  NEGATIVE  TO  UNSIGNED 

5  IF  (IGCCCT  .LT.  GCCCL)  GOTO  150  !  DID  ENTIRE  COMMAND  FIT  IN  BUFFER? 
C 

C  AT  THIS  POINT r  THE  CLI  HAS  A  COMMAND  TO  BE  PROCESSED.  THE  CODE  FROM 
C  THE  LABEL  1  TO  HERE  SHOULD  BE  FAIRLY  COMMON  AMONG  ALL  CLIS. 

C  FROM  THIS  POINT  ONf  THE  CODE  WILL  BE  SPECIFIC  TO  THE  PARTICULAR  LANGUAGE 
C  THIS  CLI  IS  IMPLEMENTING.  COMMANDS  CAN  BE  ADDED  OR  DELETED  AT  WILL 
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C  BY  MODIFYING  CODE  IN  THIS  SECTION ♦  AS  STATED  ABOVE  *  THIS  EXTREMELY 
C  SIMPLE  CLI  PROVIDES  TWO  COMMANDS*  AND  GIVES  EVERYTHING  ELSE  TO  MCR ♦ 

C  THIS  CREATES  AN  OPEN-ENDED  ENVIRONMENT ♦  REJECTING  UNRECOGNIZED  COMMANDS 
C  INSTEAD  OF  PASSING  THEM  TO  MCR  WOULD  LIMIT  THE  TERMINAL  USER'S  USE  OF 
C  THE  SYSTEM  TO  ONLY  THOSE  OPERATIONS  ALLOWED  BY  THE  CLI.  THIS  IS 
C  A  SECURE  WAY  OF  CONTROLLING  SYSTEM  USE*  IN  CASES  WHEN  IT  IS  NECESSARY. 

C  IN  THIS  EXAMPLE*  CHANGING  THE  BGO  TO  50"  BELOW*  TO  A  'GO  TO  60B 
C  WOULD  CREATE  AN  ENVIRONMENT  WHERE  THE  ONLY  OPERATION  A  USER  COULD 
C  PERFORM  WOULD  BE  TO  TYPE  FILES  ON  THE  TERMINAL*  OR  SWITCH  BACK  TO  MCR. 

C  ALL  OF  THE  REST  OF  THE  SYSTEM  IS  INACCESSIBLE.  IF  NO  MEANS  OF  SWITCHING 
C  BACK  TO  MCR  IS  PROVIDED*  IT  IS  IMPOSSIBLE  FOR  THE  USER  TO  DO 
C  ANYTHING  THE  CLI  DOES  NOT  EXPLICITLY  LET  HIM  DO. 

C 

C  IS  IT  A  BTB  COMMAND? 

C 

IF  ( ( GCCBF ( 1 )  .EG.  'T'>  .AND.  <GCCBF<2)  .EG.  '  '))  GO  TO  10 

CHANGE  THE  NEXT  IF  STATEMENT  TO  BG0  TO  60B  TO  ELIMINATE  PASSING  UNKNOWN 
COMMANDS  TO  MCR. 


IS  IT  ALSO  NOT  AN  BMB  COMMAND? 


IF  ( ( GCCBF ( 1 )  ♦ NE .  'M')  .OR.  <GCCBF<2>  .NE.  13))  GO  TO  50  !  M<CR> 


THE  USER  HAS  ENTERED  AN  BMB  COMMAND*  SO  SET  THE  TERMINAL  TO  MCR. 


TCMD(l)  =  'SET  /MCR' 
TCMD ( 2 )  =  '=Ti: 

I GRP  =  I BUF ( GCCPU+ 1 ) 
IMEM  =  I BUF ( GCCPU ) 


SET  /MCR=Ti: 

(CONVERT  BYTE  TO  INTEGER)  GROUP 
MEMBER  PART  OF  UIC 


ISSUE  RPOI $  DIRECTIVE  TO  EXECUTE  COMMAND 


CALL  RPOI (I MCR* I  GRP* I MEM*  * TCMD *12*  * GCCDV *  I GCCUN *  *GCCOA*IDS) 
IF  (IDS  .LE.  0)  GO  TO  110  !  ERROR? 

GO  TO  1  !  BACK  TO  START 


THE  USER  HAS  ENTERED  A  BTB  COMMAND  SO  CONSTRUCT  THE  NECESSARY  PIP 
COMMAND  AND  SEND  IT  TO  MCR 


10 


20 

30 


TCMD(l)  =  'PIP  Ti:«' 

12  =  8 

DO  20*  II  =  10*  CBLEN 
IF  (CMDBUF(Il)  .EG. 
IF  (CMDBUF(Il)  .EG. 
12  =  12  +  1 
BUF ( 12 )  =  CMDBUF(Il) 
CONTINUE 

I6RP  =  IBUF ( GCCPU+1 ) 
IMEM  =  IBUF ( GCCPU ) 


!  PUT  BEGINNING  OF  PIP  CMD  IN  BUFFER 
!  POINTER  INTO  TARGET  BUFFER 
!  BEGIN  AT  SPACE  AFTER  THE  T  IN  CMDBUF 
13)  GO  TO  30  !  END  OF  COMMAND?  (<CR>) 

'  ')  GO  TO  20  !  SKIP  ANY  SPACES 
!  COUNT  CHARACTER 
!  COPY  INTO  OUTPUT  BUFFER 

!  (CONVERT  BYTE  TO  INTEGER)  GROUP 
!  MEMBER  PART  OF  UIC 


ISSUE  RPOI ♦  DIRECTIVE  TO  EXECUTE  COMMAND 

CALL  RPOI (I MCR* IGRP* IMEM*  * TCMD *  1 2  *  * GCCDV *  I GCCUN *  *GCCOA* IDS) 
IF  (IDS  .LE.  0)  GO  TO  110  !  ERROR? 

GO  TO  1  !  BACK  TO  START 
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C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 


IN  THE  ABOVE  SECTION  OF  CODE  *  THE  RPOI  DIRECTIVE  WAS  USED  TO  PASS 
THE  PIP  COMMAND  TO  THE  MAIN  COMMAND  DISPATCHER  ( MCR  *  .  *  )  * 

WHICH  WILL  START  A  COPY  OF  PIP  AND  GIVE  IT  THE  COMMAND*  THE  RPOI 
DIRECTIVE  COULD  BE  USED  TO  GIVE  THE  COMMAND  DIRECTLY  TO  . **PIP  AND 
GIVE  THE  RESULTING  TASK  A  DIFFERENT  NAME.  IN  THIS  EXAMPLE  * 

WE  COULD  CALL  THE  RESULTING  PIP  TASK  "TYPTNN"  WHERE  THE  LAST 
THREE  CHARACTERS  ( TNN )  ARE  REPLACED  BY  A  DEVICE  NAME  CHARACTER  AND 
UNIT  NUMBER*  FOR  EXAMPLE  *  IF  THE  " T ■  COMMAND  WAS  TYPED  ON  TTIOJ 
THE  RESULTING  TASK  NAME  COULD  BE  MADE  TO  BE  "TYPTIO".  THIS  HAS  THE 
ADVANTAGE  OF  ALLOWING  THE  TASK  TO  BE  ABORTED  BY  AN  "ABO  TYP"  COMMAND  * 
INSTEAD  OF  "ABO  PIP- *  THUS  THE  USER  WOULD  NOT  HAVE  TO  KNOW  THAT  THE 
'T*  COMMAND  HE  ISSUED  IS  ACTUALLY  BEING  SERVICED  BY  THE  PIP  TASK.  THIS 
IS  EXACTLY  WHAT  THE  DCL  CLI  DOES.  IT  IS  NOT  DONE  HERE  IN  ORDER 
TO  SIMPLIFY  THE  EXAMPLE.  PICKING  UP  THE  TERMINAL  NAME  AND  UNIT 
NUMBER*  CONVERTING  IT  TO  RAD50  *  AND  SUPPLYING  IT  IN  THE  RPOI  DIRECTIVE 
ALONG  WITH  A  DIRECT  REQUEST  OF  PIP  IS  LEFT  AS  AN  EXERCISE  TO  THE  USER. 
(BE  CAREFUL  ON  RSX- 1 1 M-PLUS  SYSTEMS  WITH  MORE  THAN  64.  TERMINALS). 

NOTE  THAT  REQUESTING  PIP  DIRECTLY  AVOIDS  A  SUBSTANTIAL  AMOUNT  OF  SYSTEM 
OVERHEAD. 


COMMAND  IS  NOT  ■ T  *  OR  BMB * 


SO  GIVE  IT  TO  MCR  AS  IS. 


50  I GRP  =  IBUF ( GCCPU+1 ) 
IMEM  =  IBUF ( GCCPU ) 
IGCCCT  =  GCCCT 


(CONVERT  BYTE  TO  INTEGER)  GROUP 
MEMBER  PART  OF  UIC 
#  OF  CHARS  IN  COMMAND 


ISSUE  RPOI$  DIRECTIVE  TO  EXECUTE  COMMAND 


CALL  RPOI(IMCR*IGRP*IMEM*  * GCCBF *  I GCCCT *  *  GCCDV  *  I GCCUN  * *GCCOA*IDS> 
IF  (IDS  . LE »  0)  GO  TO  110  !  ERROR? 

GO  TO  1  !  BACK  TO  START 

CONTROL  IS  TRANSFERRED  HERE  IF  UNKNOWN  COMMANDS  ARE  TO  BE  REJECTED 
INSTEAD  OF  BEING  PASSED  TO  MCR. 


60  WRITE  (5*62) 

62  FORMAT ( ' 0 ILLEGAL  COMMAND  '  ) 

GO  TO  1  !  BACK  TO  START 


ERROR  HANDLING  CODE 


C 


C 


100  WRITE  (5*102)  IDS  !  ERROR  IN  GTCMCI 

102  FORMAT( 'OFATAL  ERROR  IN  GTCMCI  DIRECTIVE.  DSW='*I6) 

GO  TO  250  !  EXIT 

110  WRITE  (5*112)  IDS  !  ERROR  IN  RPOI 

112  FORMAT ( ' OFATAL  ERROR  IN  RPOI  DIRECTIVE.  DSW='*I6) 

GO  TO  250  !  EXIT 

150  WRITE  (5*152)  !  ENTIRE  COMMAND  DID  NOT  FIT  IN  BUFFER 

152  FORMAT ( ' OSORRY  *  PART  OF  YOUR  COMMAND  WAS  LOST '  ) 

GO  TO  1  !  BACK  TO  START 


11-19 


non  non  non  ono 


COMMAND  LINE  INTERPRETERS 


A  SYSTEM  MESSAGE  WAS  RECEIVED  INSTEAD  OF  A  COMMAND 
200  CONTINUE 

IF  ( GCCUN  . EG) •  CMLKT )  GO  TO  210  !  IS  IT  A  NEW  TERMINAL  LINKED  TO  US? 

IF  (GCCUN  .EQ.  CMRMT )  GO  TO  220  !  IS  IT  A  TERMINAL  BEING  REMOVED? 

IF  (GCCUN  .EQ.  CMEXT )  GO  TO  250  !  IS  IT  AN  ELIMINATE  ALL  PACKET? 

IF  (GCCUN  .EQ.  CMELM )  GO  TO  250  !  IS  IT  A  CLI  ELIMINATION  MESSAGE? 

GO  TO  1  !  IGNORE  ALL  OTHER  MESSAGES 

ISSUE  WELCOME  MESSAGE 

210  IGCCUN  =  CMDBUF (11)  !  CONVERT  BYTE  TERMINAL  UNIT  #  TO  INTEGER 

CALL  ASNLUN(5»GCCBF. IGCCUN. IDS)  !  ASSIGN  LUN  5  TO  SPECIFIED  DEVICE 
WRITE  (5.212) 

212  FORMAT( 'OWELCOME  TO  THE  EXAMPLE  CLI') 

GO  TO  1  !  BACK  TO  START 

ISSUE  GOODBYE  MESSAGE 

220  IGCCUN  =  CMDBUF (11)  !  CONVERT  BYTE  TERMINAL  UNIT  *  TO  INTEGER 

CALL  ASNLUN(5.GCCBF. IGCCUN. IDS)  !  ASSIGN  LUN  5  TO  SPECIFIED  DEVICE 
WRITE  (5.222) 

222  FORMAT ( 'OGOOD  BYE  FROM  THE  EXAMPLE  CLI') 

GO  TO  1  !  BACK  TO  START 

WHEN  AN  ELIMINATE  ALL  MESSAGE  IS  RECEIVED.  EXIT  IMMEDIATELY 

250  CONTINUE 

CALL  EXIT 
END 
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The  DIGITAL  Command  Language  (DCL)  is  a  general  purpose  command 
language  syntax  implemented  on  several  DIGITAL  operating  systems. 


12.1  INTRODUCTION 

DCL  on  RSX-1 1 M/M- PLUS  systems  is  a  task  that  receives  DCL  commands  by 
means  of  the  generalized  CLI  command  dispatcher ,  translates  the  DCL 
commands  to  equivalent  MCR  commands,  and  sends  the  MCR  commands  to  the 
MCR  command  line  interpreter  for  interpretation  and  execution.  The 
DCL  task,  in  conjunction  with  the  CLI  dispatcher,  provides  DCL  support 
on  RSX-1 1 M/M- PLUS  operating  systems. 

This  chapter  explains  the  ways  in  which  DCL  can  be  installed  on  your 
system  and  documents  the  means  by  which  the  DCL  task  parses  and 
translates  commands.  In  addition,  this  chapter  documents  the  Macro 
MetaLanguage ,  a  set  of  MACRO-11  macros  used  to  define  DCL.  An 
experienced  programmer  can  add  commands  to  DCL  or  remove  them,  or 
alter  DCL  by  changing  parts  of  it,  such  as  altering  defaults  or 
eliminating  qual i f iers . 

For  information  on  DCL  syntax  and  functions,  see  the  RSX-1 1M/M-PLUS 
Command  Language  Manual .  For  information  on  MCR  syntax  and  functions, 
see  the  RSX-1 1 M/M- PLUS  MCR  Operations  Manual .  For  information  on  the 
CLI  command  dispatcher,  and  on  alternate  CLIs,  see  Chapter  11,  Command 
Line  Interpreters,  in  this  manual.  For  information  on  the  Executive 
directives  used  to  implement  alternate  CLIs,  see  the  RSX-1 1M/M-PLUS 
Executive  Reference  Manual. 

The  examples  of  source  code  in  this  chapter  illustrate  features  of  DCL 
and  the  DCL  task,  but  they  are  often  changed  from  the  actual  source 
code  to  make  the  example  clearer.  See  the  DCL  source  code  in  [23,10] 
for  exact  information.  The  command  tables  for  the  ASSIGN  command  are 
included  in  this  chapter  (Section  12.11.6)  as  a  general  example  of  DCL 
coding . 


12.2  INSTALLING  AND  BUILDING  DCL 

The  DCL  task  is  best  installed  as  an  alternate  CLI,  but  it  can  also  be 
run  as  a  task  or  installed  as  an  external  MCR  task.  External  MCR 
tasks  have  task  names  in  the  form  ...abc.  Furthermore,  you  can 
rebuild  DCL  either  to  eliminate  direct  access  to  MCR  from  DCL,  or  to 
allow  all  commands  not  in  DCL  syntax  to  fall  through  DCL  for  handling 
by  MCR.  Your  choice  on  these  options  depends  on  the  nature  of  your 
users  and  your  installation. 
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12.2.1  Conventional  Installation  of  DCL  as  a  CLI 

Installing  DCL  as  an  alternate  CLI  is  the  cleanest  use  of  DCL.  This 
allows  you  to  classify  users  by  CLI  in  the  system  account  file.  Users 
can  log  in  using  either  HELLO  or  LOGIN.  The  HELLO  task  checks  the 
account  file  for  the  CLI  and  sets  the  user's  terminal  to  the 
designated  CLI. 

On  RSX-11M  systems ,  DCL  and  alternate  CLI  support  require  a  mapped 
system  with  multiuser  protection.  If  you  choose  DCL  at  system 
generation,  you  are  also  choosing  alternate  CLI  support,  as  DCL  is  an 
alternate  CLI.  In  addition,  choosing  DCL  support  also  gives  you 
support  for  the  following  directives: 

•  Stop-bit 

•  Install- request- remove 

•  Parent-offspring  tasking  with  chaining 

•  AST 

•  Specify  request  exit  AST 

•  Get  task  parameters 

•  Get  command  for  command  interpreter 

•  Request  and  pass  offspring  information 

•  Specify  command  arrival  AST 

•  Get  command  interpreter  information 

The  last  four  directives  listed  are  those  specifically  added  for 
alternate  CLI  support.  See  Chapter  11,  "Command  Line  Interpreters," 
and  the  RSX- 11 M/M- PLUS  Executive  Reference  Manual . 

During  system  generation  on  RSX-1 1M-PLUS ,  you  are  asked  if  you  want 
alternate  CLI  support  or  DCL  support.  The  other  (non-CLI)  directives 
listed  above  are  supported  on  all  RSX-11M-PLUS  systems  with  the 
full-function  Executive . 

Installing  DCL  as  an  alternate  CLI  on  either  RSX-11M  or  RSX-11M-PLUS , 
requires  only  two  commands: 

MCR>INSTALL  $DCL . TSK/CLI=YES 
MCR>CLI  /INIT=DCL 

When  you  choose  DCL  support  during  system  generation,  the  INSTALL 
command  is  issued  in  the  SYSVMR  portion  of  system  generation  and  the 
CLI  /INIT  command  must  be  included  in  the  system  STARTUP . CMD  file. 


12.2.2  Alternative  Ways  to  Use  DCL 

If,  for  some  reason,  you  choose  not  to  have  alternate  CLI  support,  you 
can  still  use  many  of  the  features  of  DCL  by  taking  advantage  of 
alternative  ways  of  installing  DCL.  You  can  run  DCL  as  a  task, 
install  DCL  as  an  external  MCR  task  under  the  name  ...DCL,  or  install 
DCL  as  the  system  catchall  task  under  the  name  ...CA. 
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If  DCL  is  not  a  CLI ,  you  cannot  log  in  with  LOGIN ,  you  cannot  change 
your  defaults  with  SET  DEFAULT ,  breakthrough  writes  do  not  break 
through ,  and  spawned  tasks  are  not  renamed.  That  is,  a  DIRECTORY 
command  spawns  a  task  named  PIPTnn,  not  DIRTnn . 


12.2.2.1  Run  DCL  as  a  Task  -  If  you  wish,  you  can  simply  run  DCL  as  a 
task.  If  you  place  the  task  image  file  in  the  system  directory  on 
RSX-11M  or  the  library  directory  on  RSX-11M-PLUS ,  users  can  run  DCL 
with  the  command: 

>RUN  $DCL 

DCL  runs  from  your  terminal  as  a  task.  The  terminal  remains  set  to 
MCR.  All  DCL  commands  work  in  the  normal  way,  but  a  carriage  return 
on  a  line  by  itself  causes  the  task  to  exit. 


12.2.2.2  Install  as  ...DCL  -  If  you  install  the  DCL  task  as  an 
external  MCR  task  under  the  name  ...DCL,  users  can  issue  DCL  commands 
from  an  MCR  terminal  simply  by  preceding  the  command  with  DCL,  as  in 
the  following  example: 

MCR>DCL  SHOW  USERS 


12.2.2.3  Install  as  ...CA.  -  If  you  install  the  DCL  task  under  the 
name  ...CA.,  all  commands  not  recognized  by  MCR  are  handled  by  DCL 
running  as  the  catchall  task.  This  means  that  DCL  commands  such  as 
MOUNT  and  SET  that  are  identical  with  MCR  commands  in  the  first  three 
characters  must  be  in  MCR  syntax.  These  commands  in  DCL  syntax  are 
recognized  by  MCR,  but  only  as  errors.  To  avoid  infinite  loops,  the 
DCL  installed  as  MCR's  catchall  must  not  be  built  with  MCR  as  its 
catchall . 


12.2.3  The  MCR  Command 

The  MCR  command  is  included  in  the  default  DCL  task.  This  command 
permits  users  to  issue  a  one-line  MCR  command  without  leaving  DCL. 
The  MCR  command  is  not  affected  by  SET  DEBUG. 

Some  installations  may  prefer  not  to  permit  DCL  users  any  access  to 
MCR.  If  you  wish  to  restrict  access  to  MCR,  you  must  modify 
DCLBLD.CMD  following  the  instructions  contained  therein  and  then 
rebuild  DCL. 


12.2.4  Allowing  Unrecognized  Commands  to  Fall  Through  to  MCR 

The  default  DCL  task  returns  an  error  for  any  command  not  recognized 
as  a  DCL  command.  You  may  prefer  that  DCL  allow  any  unrecognized 
commands  to  fall  through  to  MCR  for  another  chance  at  execution.  This 
permits  users  direct  access  to  MCR  tasks  and  utilities  without  using 
the  MCR  command  or  the  RUN  command. 

If  you  wish  to  allow  commands  to  fall  through  DCL  to  MCR,  modify 
DCLBLD.CMD  following  the  instructions  contained  therein  and  then 
rebuild  DCL. 


12-3 


THE  DCL  TASK 


12.2.5  Flying  Installs 

Tasks  need  not  be  installed  for  DCL  to  access  them.  Comments  in 
DCLBLD.CMD  explain  how  to  enable  flying  installation  of  tasks.  Again, 
modify  DCLBLD.CMD  and  rebuild  DCL. 


12.2.6  Task-Building  DCL 

All  of  the  changes  to  DCL  described  in  this  chapter  require  that  the 
DCL  task  be  rebuilt.  This  task  build  actually  requires  two  passes  by 
the  Task  Builder  before  it  is  complete.  The  first  pass  creates  a 
symbol  table  (.STB  file)  that  is  used  by  TKB  on  the  second  pass  to 
build  the  DCL  task. 

The  file  [1,241 DCLBLD.CMD  is  called  by  SYSGEN  when  you  request  DCL 
support.  You  should  read  this  file  before  attempting  to  task-build 
DCL. 

The  overlay  structure  of  the  DCL  task  forces  a  complex  task  build. 
There  is  more  detail  about  how  the  DCL  task  works  in  the  next  section, 
but  here  is  an  outline  of  the  situation.  Each  DCL  command  is  defined 
in  a  parser  table,  or  PT,  which  defines  the  DCL  syntax  of  the  command. 
The  PT  is  paired  with  a  translator  table,  or  TT,  which  defines  the  MCR 
equivalents  for  the  DCL  command.  The  addresses  of  the  PT  and  TT  are 
included  in  a  master  command  table  (MCT)  that  lists  all  DCL  commands. 
When  DCL  parses  a  command,  it  seeks  the  address  of  that  command  in  the 
MCT  and  then  goes  to  that  address  for  translation  of  the  command  to 
MCR  at  the  PT/TT.  The  parser  tables  and  translator  tables  are 
overlaid  on  the  master  command  table.  This  means  that  at  the  time  of 
the  first  task  build,  the  master  command  table  entries  are  undefined 
symbols.  The  following  summarizes  the  process. 

The  first  task  build  uses  a  command  in  the  following  form: 

>TKB  , ,DCL.STB=DCL 

This  results  in  one  or  more  undefined  symbols  for  each  command,  but 
the  PT/TT  addresses  for  each  command  are  in  the  .STB  file. 

The  second  task  build  uses  a  command  in  the  following  form: 

>TKB  DCL , DCL=DCL , DCL . STB 

The  master  command  table  symbols  are  defined  by  means  of  the  .STB  and 
the  addresses  in  the  PT/TT  are  doubly  defined,  once  in  the  .STB  and 
once  in  their  overlays.  The  two  definitions  are  identical. 

In  fact,  this  process  is  accomplished  through  two  . ODL  files.  See 
DCLBLD.CMD  for  more  information. 


12.2.7  How  the  DCL  Task  Works 

There  are  three  processes  involved  in  interpreting  DCL  commands  —  the 
receive  process,  the  parser/translator  process,  and  the  send  process. 
The  receive  process  gets  the  command  line  from  the  system.  The 
table-driven  parser/translator  process  translates  the  command  line  to 
an  equivalent  MCR  command  line.  The  send  process  sends  the  equivalent 
MCR  command  line  to  the  system  for  further  interpretation  and 
execution . 
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The  receive  process  involves  two  tasks:  the  CLI  dispatcher  task 
(MCR...)  and  the  DCL  task  (...DCL).  The  CLI  dispatcher  task  gets  the 
command  line  from  the  terminal  driver ,  queues  it  to  a  CLI  queue ,  and 
activates  the  DCL  task  (if  not  already  active).  The  DCL  task 
activated  is  named  DCLTnn,  where  nn  is  the  number  of  the  issuing 
terminal.  The  DCL  task  (being  nonpr i v ileged )  issues  the  Get  Command 
for  Command  Interpreter  (GCCI$)  directive  to  remove  (or  receive)  the 
command  line  from  the  CLI  queue. 

The  parser/translator  process  involves  two  subprocesses:  the  parser 
process  and  the  translator  process.  The  parser  process  checks  syntax 
to  ensure  that  the  received  command  line  is  a  valid  DCL  command  line. 
The  parser  constructs  an  intermediate  form  (/FORM)  to  pass  data  about 
the  command  line  to  the  translator.  The  translator  process  uses  this 
data  to  construct  an  equivalent  MCR  command  line  from  the  valid  DCL 
command  line. 


The  send  process  dispatches  the  equivalent  MCR  command  line  to  MCR  or 
MCR  utility  tasks  by  means  of  the  Request  and  Pass  Offspring 
Information  (RPOI$)  directive.  The  RPOI$  directive  is  functionally 
similar  to  the  SPWN$  directive.  There  are  two  significant  differences 
from  SPWN$ :  RPOI$  allows  the  spawned  task  to  be  named  (for  example, 
spawn  PIP  and  name  it  COPTnn) ,  and  RPOI$  does  not  create  OCBs 
(Offspring  Control  Blocks) . 


The  DCL  task  needs  the  task-naming  ability  to  track  the  association 
between  the  DCL  command  name  and  the  MCR  or  utility  task  that  executes 
the  command.  And,  instead  of  creating  an  OCB,  RPOI$  takes  the  OCB 
attached  to  the  DCL  task  and  attaches  this  OCB  to  the  spawned  task. 
This  enables  the  spawned  task  to  communicate  exit  status  directly  to 
the  parent  task,  DCL.  In  this  way,  the  DCL  task  can  spawn  a  task 
without  having  to  wait  for  the  task  to  exit. 

The  remainder  of  this  document  describes  how  to  construct  the  DCL 
command  tables,  which  drive  the  parser/translator  process.  Basically, 
the  tables  contain,  for  each  DCL  command,  the  syntax  of  the  DCL 
command,  the  syntax  of  the  equivalent  MCR  command  (that  is,  the  syntax 
of  the  MCR  command  that  the  DCL  command  translates  to) ,  and  the 
relation  (or  mapping)  between  the  DCL  syntax  and  the  MCR  syntax. 
MACRO-11  macros  and  rules  define  the  tables.  The  macros  and  rules 
form  a  language  designed  to  allow  the  user  to  express  the  tables. 


The  macros  and  rules  are  called  the  Macro  MetaLanguage  ( MML) .  Here  is 
a  list  of  some  of  the  features  of  the  language  and  how  they  are 
employed  in  the  DCL  task: 


•  MML  is  modeled  after  a  Backus-Naur  Form  (BNF)  metalanguage.  A 
BNF  language  specifies  which  sequences  of  symbols  constitute  a 
syntactically  valid  statement  in  a  given  language.  In  this 
case,  MML  is  used  to  describe  the  proper  syntax  of  a  DCL 
command  and  the  equivalent  syntax  of  an  MCR  command. 

•  MML  allows  the  specification  of  a  prompt  string  for  each 
syntax  element.  DCL  prompts  for  more  input,  with  the 
specified  string,  if  a  test  for  end-of-line  is  successful. 

•  MML  interfaces  with  the  RSX-1 1M/M-PLUS  HELP  facility.  The 
user  requests  help  by  typing  a  "?"  character  in  reply  to  a 
prompt . 


MML  allows  the  specification  of  an  error  message 
each  syntax  element.  If  DCL  detects  an  error  while 
a  syntax  element  and  that  syntax  element  has  a  spec 
message,  DCL  issues  the  error  message  and  aborts  th 


string  for 
processing 
ified  error 
e  parse. 
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•  MML  allows  the  specification  of  contradictory  bit  masks  for 
each  syntax  element.  DCL  uses  the  bit  masks  to  detect 
contradictory  syntax . 

•  MML  allows  the  use  of  globally  defined  syntax  elements,  such 
as  filespecs,  device  specs,  numerals,  letters,  alphanumer ics 
and  so  forth. 

•  MML  allows  MACRO-11  Assembly  Language  subroutines  to  be  mixed 
with  MML  statements  in  the  event  that  a  command  cannot  be 
completely  defined  using  MML. 

•  MML  allows  one  DCL  command  to  translate  to  more  than  one  MCR 
command.  For  instance,  the  DCL  SET  DEFAULT  command  can 
generate  both  an  MCR  ASN  command  and  an  MCR  SET  /UIC  command. 

•  MML  supports  floating  qualifiers.  A  floating  qualifier  can  be 
specified  anywhere  in  the  command  line. 

The  following  section  describes  the  DCL  command  tables.  The  DCL 
command  tables  define  all  DCL  commands  and  are  written  in  MML.  See 
Sections  12.6  through  12.10  for  more  information  on  MML. 


12.3  DCL  COMMAND  TABLES 

The  parser/translator  process  of  DCL  is  table-driven.  A  master 
command  table  (MCT)  contains  an  entry  for  each  DCL  command.  Each 
entry  in  the  MCT  contains  the  name  (verb)  of  the  command,  the  address 
of  a  parser  table  (PT)  for  the  command,  the  address  of  a  translator 
table  (TT)  for  the  command,  and,  optionally,  the  name  of  the  overlay 
containing  the  PT  and  the  TT.  Thus,  there  is  a  PT  and  a  TT  for  each 
DCL  command.  Each  PT/TT  contains  the  information  that  the 
parser/translator  process  needs  to  translate  a  DCL  command  line  to  an 
equivalent  MCR  command  line.  For  ease  in  adding  and  modifying 
commands,  MCT  and  each  PT/TT  are  kept  in  separate  files. 

The  file  for  the  MCT  is  called  COMMAND. MAC.  The  files  for  the  PT/TTs 
are  named  after  the  DCL  command,  with  the  type  .MAC.  For  example,  the 
PT/TT  for  the  DCL  COPY  command  is  in  a  file  named  COPY. MAC. 

The  DCL  task  uses  MCT  to  recognize  an  arbitrary  command  and  to  locate 
the  PT/TT  for  that  command.  MCT  consists  of  calls  to  the  COMMAND 
macro.  There  is  a  COMMAND  macro  for  each  DCL  command.  Arguments  to  a 
COMMAND  macro  specify  the  name  (or  verb)  of  the  command,  the  address 
of  the  PT  for  the  command,  the  address  of  the  TT  for  the  command,  and 
the  overlay  name  for  the  command. 

The  PT/TTs  drive  the  parser/translator  process.  The  parser/translator 
process  ensures  that  the  syntax  of  the  DCL  command  line  is  correct  and 
creates  the  /FORM,  which  is  the  parser  subprocess,  and  subsequently 
contructs  equivalent  MCR  command  lines,  which  is  the  translator 
subprocess.  The  PT  drives  the  parser  subprocess  and  the  TT  drives  the 
translator  subprocess.  The  PT  is  an  MML  definition  of  the  syntax  or 
structure  of  the  DCL  command  and  the  TT  is  an  MML  definition  of  the 
syntax  or  structure  of  the  corresponding  MCR  command. 

Table  12-1  shows  the  structure  of  the  DCL  command  table  files. 

The  PT  defines  the  syntax  for  a  DCL  command  line.  The  TT  defines  the 
syntax  for  the  corresponding  MCR  command  line.  For  the  translator  to 
know  which  particular  MCR  command  line  to  contruct  from  a  particular 
DCL  command  line,  the  PT  and  the  TT  must  express  a  relation  between 
the  DCL  syntax  and  the  MCR  syntax. 
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Table  12-1 
DCL  Command  Tables 


COMM AND. MAC 

ABORT. MAC 

UNLOCK. MAC 

Master  Command  Table 

ABOPT: : 

UNLPT: : 

COMMAND  ABORT  ABOPT  ABOTT 

Parser 

Parser 

COMMAND  ASSIGN  ASSPT  ASSTT 

Table 

Table 

• 

• 

COMMAND  UNLOCK  UNLPT  UNLTT 

ABOTT: : 

Translator 

Table 

UNLTT: : 

Translator 

Table 

The  PT/TT  expresses  this  relation  by  mapping  elements  from  DCL  syntax 
to  elements  in  MCR  syntax.  For  example ,  the  DCL  qualifier  "/GLOBAL” 
maps  to  the  MCR  switch  "/GBL"  (that  is,  the  switch  "/GBL"  is  output 
when  the  qualifier  "/GLOBAL"  is  input) . 

The  parser  passes  the  mapping  information  to  the  translator  by  means 
of  a  dynamic  data  structure  called  the  Intermediate  Form  ( I FORM) .  The 
parser  constructs  the  I FORM  and  the  translator  examines  the  I FORM . 
The  I FORM  contains  the  essential  information  that  the  translator  needs 
to  contruct  the  equivalent  MCR  command  line.  Both  the  PT  and  the  TT 
define  the  mapping  from  DCL  to  MCR  syntax. 

The  Macro  MetaLanguage  (MML)  defines  the  PT  and  the  TT.  MML  is  a  set 
of  MACRO-11  macros  and  rules  implementing  a  language  in  which  a  user 
can  define  DCL  commands.  With  MML,  a  user  can  express  the  information 
in  the  PT  and  the  TT  in  a  BNF-type  metalanguage. 

The  following  section  describes  the  structure  of  the  file  that 
contains  the  MCT  and  of  the  files  that  contain  the  PT/TTs .  It  also 
describes  how  these  files  assemble,  overlay,  and  task  build  into  the 
DCL  task.  Section  12.4.1.1  describes  how  to  create  the  PTs  and  TTs . 


12.4  MODIFYING  DCL  COMMAND  TABLES 

A  DCL  command  consists  of  an  entry  in  the  master  command  table  (MCT) , 
a  parser  table  (PT)  ,  and  a  translator  table  (TT) .  The  PT  defines  the 
syntax  of  the  DCL  command.  The  TT  defines  the  syntax  of  the 
corresponding  MCR  command.  The  entry  in  the  MCT  connects  the  PT  and 
the  TT  to  the  DCL  task.  Thus,  to  add  a  new  command  to  the  DCL  task 
the  user  must  construct  a  PT  and  a  TT  and  make  an  entry  in  the  MCT. 


12.4.1  Adding  Commands 

Adding  a  command  to  the  DCL  task  involves: 

1.  Creating  the  PT  and  the  TT 

2.  Creating  the  file  that  contains  the  PT  and  the  TT 

3.  Making  an  entry  in  the  MCT 
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4.  Making  an  entry  in  the  overlay  description  file  for  the  DCL 
task 

5.  Incorporating  the  new  PT/TT  file  and  the  modified  MCT  file 
into  the  DCL  task 


12.4.1.1  The  PT/TT  File  -  The  file  that  contains  the  PT  and  the  TT  is 
named  after  the  verb  of  the  command.  The  file  type  is  .MAC  (for 
example ,  the  PT  and  the  TT  for  the  COPY  command  are  in  a  file  named 
COPY. MAC).  The  PT/TT  file  must  specify  the  MACRO-11  assembly 
directives  .TITLE ,  .PSECT,  and  .END.  The  title  of  the  file  (specified 
as  an  argument  to  the  .TITLE  directive)  must  also  be  the  same  as  the 
verb  of  the  command.  Normally,  the  program-section  name  is  . CDEF, 
which  stands  for  command  definition.  If,  however,  MACRO-11 
subroutines  are  interspersed  with  MML  notation  by  means  of  the  $JSR 
predefined  syntax  element,  the  subroutines  must  be  in  the  blank 
program  section.  (See  Section  12.11  for  details  on  $JSR.) 

In  addition  to  these  directives,  the  PT/TT  file  must  contain  a 
(MACRO-11)  global  label  on  the  first  MML  macro  of  the  PT  and  a  global 
label  on  the  first  MML  macro  of  the  TT.  By  convention,  the  label  on 
the  PT  is  the  same  as  the  verb  of  the  DCL  command,  and  the  label  on 
the  TT  is  the  same  as  the  verb  on  the  corresponding  MCR  command.  The 
following  shows  the  structure  of  the  file  that  contains  the  PT  and  the 
TT  for  the  DCL  ASSIGN  command. 


ASSIGN. MAC 


.TITLE 

ASSIGN 

.PSECT 

.CDEF 

ASSIGN: : 

Parser 

Table 

ASN :  : 

Translator  Table 

.END 

The  two  global  labels  in  the  PT/TT  file  connect  the  PT  and  the  TT  to 
the  DCL  task.  This  is  accomplished  by  making  an  entry  in  the  MCT. 


12.4.1.2  The  MCT  Entry  -  The  file  COMMAND. MAC  contains  the  master 
command  table  (MCT).  The  MCT  consists  of  a  list  of  (MACRO-11)  COMMAND 
macrocalls.  Each  COMMAND  macrocall  identifies  a  DCL  command.  The 
list  of  COMMAND  macrocalls  is  ordered  alphabetically  by  the  name  or 
verb  of  the  command.  The  COMMAND  macro  takes  five  arguments.  The 
first  four  are  mandatory  and  the  fifth  is  optional.  The  format  for 
the  COMMAND  macro  is  as  follows: 

COMMAND  name,  min,  ptaddr,  ttaddr,  [ovrnaml 

where 

name  Name  or  verb  of  the  command 

m*n  Minimum  number  of  characters  necessary  to  make  the  name 

unique 
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ptaddr  Label  of  the  PT  for  the  command 
ttaddr  Label  of  the  TT  for  the  command 

[ovrnaml  Three-character  name  of  the  overlay  for  the  PT  and  TT 

The  fifth  argument  to  the  COMMAND  macro  (ovrnam)  is  optional.  The  PT 
and  TT  must,  however f  be  in  an  overlay  whether  or  not  you  specify  this 
argument.  The  default  overlay  name  is  the  command  verbf  assuming  the 
PT  and  TT  are  in  the  same  module.  If  they  are  in  separate  modules , 
the  PT  overlay  is  named  for  the  verb  by  default ,  and  the  TT  is  named 
for  the  verb  preceded  by  a  "T"  (for  example,  TSET . MAC) • 

The  MCT  is  in  two  parts.  Part  1  of  the  MCT  includes  all  DCL  command 
verbs  in  alphabetical  order,  as  described  in  this  section.  Part  1  is 
searched  with  a  binary  search  algorithm.  Part  2  of  the  MCT  makes 
possible  the  brief  forms  of  commonly  used  DCL  commands.  If  the  search 
of  Part  1  for  a  command  verb  fails  —  if  a  line  is  too  short,  for 
instance  —  a  search  of  Part  2  is  initiated.  Part  2  is  not 
necessarily  in  alphabetical  order  as  it  is  searched  from  the  top  down. 


12.4.1.3  The  Overlay  Entry  -  Each  PT/TT  must  reside  in  an  overlay. 
Use  one  of  the  following  structures  to  overlay  a  PT/TT: 

1.  One  overlay  for  two  or  more  PT/TTs 

2.  One  overlay  for  one  PT/TT 

3.  Two  overlays  for  one  PT/TT 

4.  More  than  two  overlays  for  one  PT/TT 

Specify  an  overlay  by  making  an  entry  in  the  overlay  description  files 
—  DCLBLD.ODL  and  DCDBLD.ODL  —  and  connect  the  new  overlay  entry  to 
the  root  segment  overlay  entry.  For  the  first  type  of  overlay 
structure  previously  noted  (one  overlay  for  two  or  more  PT/TTs) ,  the 
format  for  the  overlay  entry  is  as  follows: 

.NAME  ovrnam 

label:  .FCTR  ovrnam-DCLO/LB : cmdnaml : cmdnam2 . . . : cmdnamn-L 

where 

label  Connects  the  entry  to  the  root  segment 
ovrnam  Three-character  name  of  the  overlay 

DCLO  Object  library  containing  the  modules  in  the  overlays 
cmdnaml  Title  of  the  file  containing  the  first  PT/TT 
cmdnam2  Title  of  the  file  containing  the  second  PT/TT 


cmdnamn  Title  of  the  file  containing  the  last  PT/TT 

For  each  entry  in  the  MCT  whose  command  tables  (PT/TTs)  are  in  an 
overlay  that  has  two  or  more  PT/TTs,  you  must  include  the  overlay 
name,  ovrnam. 
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For  the  second  overlay  structure  previously  noted  (one  PT/TT  per 
overlay) ,  the  entry  has  the  following  format: 

label:  . FCTR  DCLO/LB : cmdnam-L 

where 

label  Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT/TT 

This  structure ,  one  overlay  and  one  PT/TT ,  does  not  specify  the 
overlay  name.  In  this  case,  the  DCL  task  uses  the  name  or  verb  of  the 
command  as  the  overlay  name  since  the  Task  Builder  default  for  the 
overlay  name  is  the  title  of  the  file.  For  this  reason,  the  title  of 
the  file  containing  the  PT/TT  must  be  the  same  as  the  name  or  verb  of 
the  command. 

For  the  third  overlay  structure  (two  overlays  and  one  PT/TT) ,  the 
entry  has  the  following  format: 

label :  . FCTR  (DCLO/LB : cmdnam-L , DCLO/LB : tcmdnam-L ) 

where 


label 

Connects 

the 

entry 

to 

the  root 

segment 

cmdnam 

Title 

of 

the 

file 

that 

contains 

the 

PT 

tcmdnam 

Title 

of 

the 

file 

that 

contains 

the 

TT 

Note  that  this  overlay  structure,  two  overlays  and  one  PT/TT,  requires 

that  the  PT  and  TT  reside  in  separate  files.  The  separate  files  have 

the  same  format  as  a  single  file  that  contains  the  PT/TT  except  that 
there,  is  only  one  global  label  in  each  file.  By  convention,  the  file 

containing  the  PT  is  named  for  the  verb  of  the  command  and  the  file 

containing  the  TT  is  named  for  the  verb  prefixed  by  "T" .  The  titles 
of  the  files  follow  the  same  convention.  For  example  the  file 
containing  the  PT  for  the  DCL  SET  command  is  named  SET. MAC  with  title 
SET,  and  the  file  containing  the  TT  for  the  DCL  SET  command  is  named 
TSET • MAC  with  title  TSET. 

For  the  fourth  overlay  structure  (more  than  two  overlays  and  one 
PT/TT),  the  entry  has  the  following  format: 

label:  .FCTR 

(DCLO/LB : cmdnam-L, DCLO/LB: tcmdnam-L, DCLO/LB :ovrnaml-L) 

where 

label  Connects  the  entry  to  the  root  segment 

cmdnam  Title  of  the  file  that  contains  the  PT 

tcmdnam  Title  of  the  file  that  contains  the  TT 

ovrnaml  Title  of  a  file  containing  more  parts  of  the  PT/TT 

Basically,  the  overlay  structure  of  more  than  two  overlays  and  a 
single  PT/TT  allows  a  PT  or  a  TT  to  invoke  additional  overlays 
containing  additional  portions  of  the  PT  or  TT.  Since  the  PT  and  TT 
are  read-only  data,  the  additional  overlay  segments  are  loaded  on  top 
of  the  overlay  that  is  invoking  them.  On  return  from  the  invoked 
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overlay f  the  DCL  task  reloads  the  previous  overlay.  Control  returns 
to  the  point  in  the  previous  overlay  whence  the  additional  overlay  was 
invoked . 

Use  the  $CALLOV  predefined  syntax  element  to  invoke  additional 
overlays  from  a  PT  or  a  TT.  (See  Section  12.11,  for  details  on  the 
$CALLOV  predefined  syntax  element.)  To  specify  additional  overlays, 
repeat  the  format  above.  That  is,  for  each  additional  overlay, 
specify  an  additional  argument  to  the  .FCTR  directive  using  the 
format :  DCLO/LB:ovrnam-L. 

Next,  connect  the  new  overlay  entry  to  the  root  segment  of  the  DCL 
task  by  adding  the  label  of  the  entry  to  the  list  of  labels  for  other 
entries.  The  list  of  labels  for  other  entries  is  found  in  the  overlay 
description  file  after  the  label  OLAY.  By  convention,  enter  the 
labels  in  alphabetical  order.  The  following  shows  the  list  of  overlay 
entry  labels: 

OLAY:  .FCTR  (11, 12, 13, 14, 15,..., In) 


where 


11 , . . . , In  Labels  of  overlay  entries 

Note  that  since  there  are  two  overlay  description  files  for  building 
the  DCL  task  (DCLBLD.ODL  and  DCDBLD.ODL),  you  must  make  new  overlay 
entries  in  both  files.  The  format  is  the  same  for  both  overlay 
description  files.  For  details  on  how  to  build  the  DCL  task,  see 
Section  12.2.  For  details  on  overlay  structures,  see  the 
RSX-1 1 M/M- PLUS  Task  Builder  Manual. 

The  last  step  required  to  add  a  command  to  the  DCL  task  is  to 
incorporate  all  created  or  modified  files  into  the  DCL  task. 


12.4.1.4  Incorporating  the  PT/TT  and  MCT  -  The  last  step  in  adding 
new  commands  to  DCL  —  assembly  and  task  building  —  is  accomplished 
through  the  indirect  command  file  [ 23 , 24 ] DCL . CMD,  which  is  on  the  same 
disk  as  the  DCL  sources.  This  file  prompts  for  the  name  of  a  file 
containing  the  names  of  all  modules  you  have  changed  or  created.  The 
input  file  consists  of  one  module  name  per  line,  with  no  file  type  or 
version  number.  DCL. CMD  then  assembles  the  modules,  updates  the 
object  libraries,  and  task-builds  the  new  version  of  DCL. 

Invoke  DCL. CMD  as  follows: 

>@DCL 

*Do  you  want  expanded  comments;  [Y/N] : 

Answer  Y  to  this  question.  The  comments  in  DCL. CMD  direct  the 
remainder  of  the  process. 

If  all  source  files  assemble  correctly,  DCL. CMD  then  builds  the  DCL 
task.  See  Section  12.2  for  information  on  how  to  determine  if  the  DCL 
task  was  built  correctly  and  for  information  on  how  to  install  DCL  as 
a  CLI  in  a  multi-CLI  environment. 

The  DCL. CMD  command  file  is  designed  to  run  under  MCR  with  MAC,  LBR, 
PIP,  and  TKB  installed.  DCL. CMD  is  designed  to  run  using  one  UFD,  the 
UFD  that  you  invoke  the  command  file  from.  This  means  that  the 
following  files  must  be  in  this  UFD: 

•  Specified  source  files 
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•  Library  files  for  DCL:  DCLO.OLB  and  DCLR.OLB,  the  overlay  and 
root,  respectively, 

•  Prefix  files  for  DCL:  DCLMAC . MAC  and  COMMAC.MAC 

•  Task-build  command  file:  DCLBLD.CMD 

•  Overlay  description  files:  DCLBLD.ODL  and  DCDBLD.ODL 

Additionally,  RSXMC.MAC  must  be  in  LB: [11,10].  Although  DCL  is 
nonpr ivileged ,  DCL  needs  this  file  to  determine,  at  assembly  time, 
whether  your  system  is  RSX-11M  or  RSX-11M-PLUS. 


12.4.2  Deleting  Commands 

To  delete  a  command  from  DCL,  you  must  break  the  link  between  the  MCT 
and  the  PT/TT.  To  do  this,  delete  the  appropriate  COMMAND  macro  entry 
in  the  MCT,  which  is  in  the  file  COMMAND. MAC.  Then  incorporate  the 
modified  COMMAND. MAC  file  into  the  DCL  task  by  following  the  procedure 
outlined  in  the  preceding  section.  You  can  also  delete  the  entry  in 
the  overlay  description  files  and  the  object  modules  for  the  PT/TT  in 
the  DCLO.OLB  library,  but  this  is  optional. 


12.4.3  Modifying  Commands 

Modifying  an  existing  DCL  command  involves  modifying  the  PT/TT  files 
to  reflect  the  desired  change  and  incorporating  the  modified  files 
into  the  DCL  task,  as  described  in  Section  12.4.1. 

The  user  defines  DCL  PTs  and  TTs  using  MML.  The  following  section 
describes  a  metalanguage  in  general  terms,  using  a  simple  English 
sentence  as  the  example.  Following  the  introduction  of  these  general 
concepts  in  Section  12.5  is  a  more  detailed  exposition  of  the  Macro 
MetaLanguage  (MML)  itself  in  Section  12.6.  For  instance,  the  general 
introduction  in  Section  12.5  includes  a  description  of  ANDing  and 
ORing  in  metalanguages,  while  Section  12.6  describes  the  AND  and  OR 
macros  of  the  Macro  MetaLanguage. 


12.5  A  GENERAL  DESCRIPTION  OF  A  METALANGUAGE 

Consider  a  sentence  in  the  English  language.  A  syntax  tree  defines 
the  structure  or  syntax  of  a  sentence  as  shown  below: 


<sentence> 


i - 

<sub ject> 
r  1 

1 

<pred icate> 

1 

r~ 

<article> 

| 

1  1 

<adjective>  <noun> 

1  | 

1 - - 

<verb>  <di rect 

1 

ob ject> 

THE 

>  1 

OLD  MAN 

1 

WALKED 

r 

<ar ticle> 

l 

<nounl> 

THE  dog 
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Note  that  the  sentence  "The  old  man  walked  the  dog"  is  one  of  many 
sentences  that  could  fit  the  above  structure  (syntax) .  The  following 
description  of  the  syntax  tree  is  a  metalanguage  definition  of  the 
sentence : 


sentence 

:  ;  = 

<subject>  <predicate> 

subject 

:  :  = 

<article>  <ad jective> 

predicate 

:  :  = 

<verb>  <direct  object> 

direct  object 

:  :  = 

<article>  <nounl> 

article 

:  :  = 

THE 

adjective 

:  :  = 

OLD 

noun 

:  :  = 

MAN 

verb 

:  :  = 

WALKED 

nounl 

:  :  = 

DOG 

<noun> 


Note  the  equivalence  of  the  metalanguage  definition  and  the  syntax 
tree.  They  describe  the  same  thing.  Note  also  that  the  metalanguage 
definition  uses  the  symbols  "<",  ">",  and 

The  symbols  "<"  and  ">"  denote  category  references.  These  symbols 
enclose  the  name  of  the  category.  Categories  define  classes  of 
objects.  For  example,  the  category  <subject>  defines  English  words 
that  fit  the  structure  of  an  <article>  followed  by  an  <adjective> 
followed  by  a  <noun>. 

The  symbol  means  "is  defined  as"  and  denotes  a  production  rule. 

In  a  production  rule,  you  specify  the  category  name  to  the  left  of  the 
symbol  and  the  definition  for  the  category  to  the  right  of  the 
symbol.  A  category  reference  means  there  is  a  production  rule 
for  the  category  that  requires  that  the  right  part  of  the  production 
rule  be  substitued  for  the  name  of  the  category.  For  example,  here  is 
the  production  rule  for  <subject>: 

subject  ::=  <article>  <adjective>  <noun> 

that  references  the  category  <adjective>.  The  production  rule  for  the 
category  <adjective>  is: 

adjective  : : =  OLD 

Thus,  you  can  rewrite  the  production  rule  for  <subject>  as  follows: 
subject  ::=  <article>  OLD  <noun> 

Note  that  you  can  also  substitute  further  for  references  to  the 
categories  <article>  and  <noun>  to  produce  the  production  rule: 

subject  ::=  THE  OLD  MAN 

You  cannot  substitute  for  the  words:  THE,  OLD,  and  MAN.  These  words 
are  literal  strings.  For  simplicity,  literal  strings  are  called 
literals,  and  category  references  are  called  nonliterals.  A  category 
definition  (the  right  part  of  a  production  rule)  consists  of  literals 
and  nonliterals,  or  both,  concatenated  by  impl ied-ANDs . 
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The  implied-AND  has  no  symbol  in  the  metalanguage  (thus  the  term 
implied).  Use  the  implied-AND  to  form  category  definitions  by 
concatenating  arbitrary  numbers  of  syntax  elements.  A  syntax  element 
is  either  a  literal  or  a  nonliteral.  For  example,  in  the  category 
definition  for  <subject>  are  three  nonliterals  —  <article>, 

<adjective>,  and  <noun>.  An  implied-AND  concatenates  these 

nonliterals. 

Two  additional  notations  in  the  metalanguage  are: 

Exclusive-OR  indicator  I 

Optional  syntax  indicators  [] 

Use  the  exclusive-OR  indicator  "I”  to  show  that  a  category  can  be 

defined  in  several  ways.  For  example,  here  is  the  production  rule  for 
the  category  <adjective>. 

adjective  ::=  OLD  |  YOUNG  |  MIDDLE-AGED 

When  substituting  for  a  nonliteral  with  more  than  one  definition 
(separated  by  ”  I  ” ) r  use  only  one  of  the  definitions  in  the 

substitution.  For  example,  substituting  for  the  nonliteral 
<adjective>  defined  in  this  way  in  the  production  rule  for  <subject> 
yields  one  of  the  following  three  production  rules: 

subject  ::=  THE  OLD  MAN 

or 

subject  ::=  THE  YOUNG  MAN 
or 

subject  ::=  THE  MIDDLE-AGED  MAN 

The  square  brackets,  " ["  and  "1"/  enclose  optional  syntax.  For 
example,  the  following  production  rule  defines  the  category  <subject>. 

subject  ::=  <article>  [  <adjective>  ]  <noun> 

The  square  brackets  around  the  nonliteral  <adjective>  indicate  that 
<adjective>  is  optional  syntax.  This  would  allow,  by  means  of 
substitution,  rewriting  the  production  rule  for  <subject>  to  either: 

subject  ::=  <article>  OLD  <noun> 

or 

subject  ::=  <article>  <noun> 

In  addition  to  denoting  optional  syntax,  the  square  brackets  also 
indicate  iteration.  That  is,  syntax  denoted  as  optional  can  also  be 
used  repeatedly  to  define  the  syntax.  For  example,  if  the  following 
defines  <ad jective> : 

adjective  ::=  MEAN  |  OLD  |  FAT 

then  you  could  rewrite  the  production  rule  for  <subject>  (if  <subject> 
is  defined  with  "["  and  "] "  as  above)  to: 

subject  ::=  <article>  MEAN  OLD  FAT  <noun> 


12-14 


THE  DCL  TASK 


Note,  the  repeated  substitution  for  the  nonliteral  <adjective>. 

Thus,  you  can  use  the  symbols,  rules,  and  logic  described  above  as  a 
language  (that  is,  as  a  metalanguage)  to  define  the  structure  of  other 
languages.  The  structure  or  syntax  of  a  language  is  called  the 
grammar  of  that  language.  The  grammar  is  used  to  determine 
mechanically  whether  an  arbitrary  sentence  is  a  sentence  in  the 
language . 

Our  interest  here  is  in  the  grammars  for  DCL  and  MCR,  the 
RSX-1 1M/M-PLUS  command  languages.  Sentences  in  these  two  grammars  are 
called  commands.  Here  is  a  metalanguage  definition  for  the  grammar  of 
the  DCL  ASSIGN  command: 

assign  ::=  ASSIGN  [  /  <qual>  ]  <device>  <device> 

qual  ::=  LOCAL  |  LOGIN  |  GLOBAL  |  TERMINAL:  <device> 

Here  is  a  metalanguage  definition  for  the  grammar  of  the  MCR  ASN 
command: 

asn  ::=  ASN  <device>=<device>  [  /  <qual>  ] 

qual  ::=  LOGIN  |  GBL  |  TERM=  <device> 

The  following  section  describes  the  Macro  Metalanguage  (MML) .  MML 
implements  the  logic  of  the  metalanguage  above.  MML  defines  the 
grammars  for  the  DCL  and  MCR  command  languages.  Additionally,  MML 
expresses  the  mapping  from  DCL  grammar  to  semantically  equivalent  MCR 
grammar.  MML  provides  a  more  efficient  means  of  generating  (by  means 
of  the  MACRO-11  assembler)  the  data  structures  that  drive  the 
par ser/translator  process  than  the  metalanguage  notation. 


12.6  THE  MACRO  METALANGUAGE 

The  Macro  MetaLanguage  (MML)  is  a  set  of  MACRO-11  macros  and  rules. 
The  following  describes  the  correspondence  of  the  metalanguage 
notation  presented  in  the  preceding  section  to  MML  notation. 

The  general  metalanguage  presented  in  the  preceding  section  supports 
two  logical  operators: 

implied-AND  and  exclusive-OR 

The  Macro  MetaLanguage  has  two  MACRO-11  macros  to  correspond  to  these 
logical  operators : ' 

AND  and  OR  macros 

The  general  metalanguage  presented  in  the  previous  section  supports 
two  types  of  syntax  elements: 

literals  and  nonliterals 

In  MML,  literals  and  nonliterals  are  presented  as  arguments  to  the  AND 
and  the  OR  macros. 


12-15 


THE  DCL  TASK 


In  MML,  literals  are  distinguished  from  nonliterals  by  making  the 
first  character  a  quote  character  (for  example,  'ASSIGN).  An  optional 
argument  that  you  can  specify  with  a  literal  is  the  abbreviation 
count.  The  abbreviation  count  is  a  numeral  that  indicates  the  minimum 
number  of  characters  that  the  parser  needs  to  match  for  a  successful 
parse.  For  example  you  could  rewrite 

'ASSIGN  —  to  —  < 'ASSIGN , 4> 

to  indicate  that  the  literal  "ASSIGN"  can  be  abbreviated  to  "ASSI". 


NOTE 

The  use  of  the  symbols  "<"  and  ">" 
indicates  (to  MACRO-11)  that  the 
argument  "'ASSIGN, 4"  is  one  argument 
(not  two:  ASSIGN  and  4).  Do  not 
confuse  these  symbols  with  the  identical 
metalanguage  symbols  used  to  identify 
nonliterals. 


In  the  general  metalanguage  presented  in  the  previous  section,  a 
nonliteral  is  a  reference  to  a  category.  You  define  a  category  with 
the  symbol  by  specifying  the  name  of  the  category  to  the  left  of 
the  symbol  and  the  definition  for  the  category  to  the  right  of  the 
symbol . 

In  MML,  you  define  a  category  by  placing  a  MACRO-11  label  on  either 
the  AND  or  the  OR  macro.  The  label  is  the  name  of  the  category,  and 
the  arguments  to  the  macro  are  the  definition  for  the  category.  Thus, 
in  MML,  a  nonliteral  is  the  label  (of  an  AND  or  OR  macro)  that  you  use 
as  an  argument  to  an  AND  or  OR  macro. 

For  example,  the  metalanguage  notation  for  the  category  <qual>  is: 

qual  ::=  GLOBAL  |  LOCAL  |  TERMINAL:  <device> 

The  equivalent  MML  notation  is: 

QUAL:  OR  'GLOBAL  'LOCAL  TERM 
TERM:  AND  'TERMINAL:  $DEV 

There  are  two  categories  —  QUAL  and  TERM.  There  are  three  category 
definitions  for  QUAL:  'GLOBAL,  'LOCAL,  or  TERM.  'GLOBAL  and  'LOCAL 
are  literals  and  TERM  is  a  nonliteral.  The  category  definition  — 
'TERMINAL:  $DEV  —  defines  the  category  TERM,  which  consists  of  a 
literal  'TERMINAL  and  a  predefined  nonliteral,  $DEV.  (See  Section 
12.11  for  a  description  of  $DEV) . 

Note  that  you  must  express  a  category  definition  like  'TERMINAL:  $DEV 
on  a  separate  line  (using  the  AND  macro)  because  an  argument  to  either 
the  AND  or  the  OR  macro  can  only  represent  one  syntax 
element  —  either  a  literal  or  a  nonliteral. 

Use  the  MML  notation  "OPT=T"  (optional=tr ue)  to  indicate  that  syntax 
elements  are  optional.  This  notation  corresponds  to  the  metalanguage 
notation  "["  and  The  optional  syntax  notation  "OPT=T"  is  an 
attribute  of  syntax  elements  (literals  and  nonliterals).  You 
represent  literals  and  nonliterals  in  MML  notation  as  arguments  to  AND 
and  OR  macros.  Therefore,  you  specify  the  optional  syntax  indicator 
"OPT=T"  as  part  of  the  arguments. 
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To  specify  "OPT=T”  as  an  attribute  of  a  syntax  element,  enclose  the 
syntax  element  and  the  "OPT=T"  notation  in  angle  brackets.  For 
example,  to  specify  that  the  terminal  device  specification  ($DEV)  in 
the  previous  example  is  an  optional  syntax  element  (nonliteral), 
rewrite  the  category  TERM  as  follows: 

TERM:  AND  'TERMINAL:  <$DEV  OPT=T> 

Use  the  "OPTR=T"  attribute  to  indicate  that  a  syntax  element  is 
optional  and  to  indicate  that  the  parser/translator  can  process  the 
syntax  element  repeatedly. 

The  notation  OPT  means  a  syntax  element  can  occur,  at  most,  one  time. 
The  notation  OPTR  means  a  syntax  element  can  occur  many  times.  In 
either  case,  the  element  can  occur  zero  times. 

For  a  complete  description,  see  Section  12.10. 

To  specify  an  arbitrary  number  of  arguments  for  the  AND  and  OR  macros, 
use  the  OR.,  AND.,  and  the  END  macros.  Use  the  AND.  and  OR.  macros 
as  continuation  markers  for  the  AND  and  OR  macros  respectively.  That 
is,  if  there  is  not  enough  space  on  the  line  for  all  the  arguments  to 
either  the  AND  or  OR  macros,  place  additional  arguments  on  the  next 
line.  To  do  this,  place  the  AND.  or  the  OR.  macro  on  the  next  line 
followed  by  the  continuation  of  the  specification  of  the  arguments. 
For  example,  you  could  rewrite  the  category  for  <qual>  to: 

QUAL:  OR  'GLOBAL  'LOCAL 

OR.  TERM 
END 

Use  the  END  macro  to  indicate  the  end  of  the  specification  of  the 
arguments.  Note,  to  allow  this  continuation  ability  (without  any 
additional  overhead) ,  you  need  the  END  macro  whether  or  not  you  use 
the  continuation  ability.  For  example,  you  would  need  the  END  macro 
in  the  following  category  for  <qual>: 

QUAL:  OR  'GLOBAL  'LOCAL  TERM 

END 

Thus,  you  can  use  MML  like  the  metalanguage  of  the  general  description 
in  Section  12.5  to  define  the  syntax  of  a  DCL  command  and  the  syntax 
of  the  corresponding  MCR  command.  The  parser  table  (PT)  defines  the 
syntax  of  the  DCL  command  and  the  translator  table  (TT)  defines  the 
syntax  of  the  corresponding  MCR  command.  The  following  section 
describes  how  the  PT  and  TT  drive  the  parser/translator  process  (or 
how  the  parser  and  the  translator  interpret  the  PT  and  the  TT) . 


12.7  INTERPRETING  DCL  COMMAND  TABLES 

A  parser  table  (PT)  and  translator  table  (TT)  drive  the 
parser/translator  process.  There  is  a  PT/TT  for  each  DCL  command. 
The  PT  defines  the  DCL  syntax  and  the  TT  defines  the  corresponding  MCR 
syntax.  The  parser/translator  process  locates  the  PT  and  the  TT  for  a 
particular  DCL  command  line  by  searching  the  master  command  table 
(MCT)  for  the  command  entry.  The  par ser/translator  extracts  from  the 
command  entry  the  address  of  the  first  AND  or  OR  macro  of  the  PT  and 
the  address  of  the  first  AND  or  OR  macro  of  the  TT. 
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The  parser  starts  processing  at  the  address  of  the  first  macro  in  the 
PT.  If  the  processing  of  this  macro  succeeds,  then  the  parser  process 
succeeds.  A  successful  parser  process  means  that,  at  this  point,  the 
input  command  line  is  a  syntactically  correct  DCL  command  line  (as 
defined  by  the  PT)  and  the  intermediate  form  ( IFORM)  has  been 
constructed.  The  IFORM  is  a  condensed  representation  of  the  input 
command  line.  If  the  processing  of  this  macro  fails,  then  the  parser 
process  fails. 

The  parser  processes  the  AND  macro  by  processing  ( lef t-to-r ight)  each 
argument  (syntax  element)  of  the  AND  macro  until  either  all  arguments 
process  successfully  or  an  argument  is  encountered  that  does  not 
process  successfully.  If  all  arguments  process  successfully,  then  the 
processing  of  the  AND  macro  succeeds;  otherwise,  the  processing  of 
the  AND  macro  fails. 

The  parser  processes  the  OR  macro  by  processing  (lef t-to-r ight)  each 
argument  (syntax  element)  of  the  OR  macro  until  either  the  parser 
successfully  processes  one  syntax  element  or  the  parser  fails  to 
process  any  of  the  syntax  elements.  If  the  parser  successfully 
processes  one  syntax  element,  then  the  processing  of  the  OR  macro 
succeeds;  otherwise,  the  processing  of  the  OR  macro  fails. 

The  translator  starts  processing  at  the  address  of  the  first  macro  of 
the  TT.  If  the  processing  of  this  macro  succeeds,  then  the 
translation  succeeds  and  an  equivalent  MCR  command  line  (as  defined  by 
the  TT)  has  been  constructed  from  the  IFORM.  If  the  processing  of 
this  macro  fails,  then  the  translator  process  fails.  The  processing 
of  the  AND  and  OR  macros  by  the  translator  is  the  same  as  the 
processing  of  the  AND  and  OR  macros  by  the  parser  (as  described  in  the 
previous  section) . 

Arguments  to  AND  and  OR  macros  can  be  literals  or  nonliterals. 
Nonliterals  are  handled  in  the  same  way  by  both  the  parser  and  the 
translator.  Literals,  however,  are  handled  differently  by  the  parser 
and  the  translator. 

Here  is  a  description  of  how  nonliterals  are  handled  by  both  the 
parser  and  the  translator. 

In  MML,  when  you  use  the  label  of  an  AND  or  OR  macro  as  the  argument 
to  an  AND  or  OR  macro  it  is  called  a  nonliteral;  thus,  a  nonliteral 
is  the  address  of  another  AND  or  OR  macro.  The  processing  of  a 
nonliteral  is  the  processing  of  the  other  AND  or  OR  macro  that  the 
nonliteral  addresses.  That  is,  when  the  parser  or  translator 
encounters  a  nonliteral  (as  an  argument  to  an  AND  or  OR  macro) ,  the 
parser  or  translator  transfers  parsing  or  translation  control  to  the 
macro  that  the  nonliteral  addresses.  The  addressed  macro  is  either  an 
AND  or  OR  macro  and  the  parser/translator  processes  this  macro  like 
all  AND  or  OR  macros  (as  described  in  the  previous  section) .  If  the 
processing  of  this  macro  succeeds,  then  the  processing  of  the 
nonliteral  succeeds;  otherwise  the  processing  of  the  nonliteral 
fails . 

Here  is  a  description  of  the  different  handling  of  literals  by  the 
parser  and  the  translator. 

A  string  of  ASCII  characters  used  as  an  argument  to  an  AND  or  OR  macro 
is  called  a  literal.  The  string  typically  is  a  keyword  in  the  DCL  or 
MCR  command  grammar.  The  parser  and  translator  process  literals 
differently. 
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In  parsing  a  literal ,  the  parser  attempts  to  match  the  literal  to  the 
input  DCL  command  line.  If  the  input  command  line  contains  the  same 
ASCII  string  as  the  literal,  then  the  match  is  successful  and  the 
processing  of  the  literal  succeeds;  otherwise,  nothing  happens. 

However,  in  translating  a  literal,  the  translator  copies  the  literal 
from  the  TT  to  the  MCR  command  line  buffer.  If  you  do  not  associate 
attributes  with  a  literal  in  a  TT,  then  the  processing  of  the  literal 
always  succeeds.  (Writing  a  literal  to  the  MCR  command  line  buffer 
always  succeeds.)  A  literal  in  a  TT  can  fail  only  if  you  have 
associated  one  of  the  following  attributes  with  the  literal: 

MAP,  CBM,  BCT ,  BST 

With  these  attributes  associated  with  a  literal,  the  translator 
processes  the  attributes  before  the  literal  is  written  to  the  MCR 
command  line  buffer. 

The  MAP  attribute  instructs  the  translator  to  check  for  a  mapping 
number  in  the  IFORM.  If  the  number  is  not  there,  the  translator  does 
not  write  the  literal  to  the  MCR  command  line  buffer  and  the 
processing  of  the  literal  fails. 

The  CBM,  BCT,  and  BST  attributes  instruct  the  translator  to  check  the 
status  of  certain  bits  in  its  internal  data  structures.  If  the  status 
of  the  bits  is  not  correct,  the  translator  does  not  write  the  literal 
to  the  MCR  command  line  buffer  and  the  processing  of  the  literal 
fails.  See  Section  12.10  for  more  information  on  these  attributes). 

In  summary,  the  parser  table  (PT)  drives  the  parser  and  the  translator 
table  (TT)  drives  the  translator.  The  parser/translator  succeeds  only 
if  the  processing  of  the  first  AND  or  OR  macro  of  the  PT/TT  succeeds. 
The  processing  of  an  AND  or  OR  macro  succeeds  only  when  the  processing 
of  the  arguments  to  the  macros  succeed.  Arguments  can  be  either 
literals  or  nonliterals.  A  nonliteral  instructs  the  parser/translator 
to  process  (recursively)  another  AND  or  OR  macro  and  succeeds  only  if 
the  subsequent  AND  or  OR  macro  succeeds.  A  literal  instructs  the 
parser  to  ensure  the  input  command  line  matches  the  literal  and 
succeeds  only  if  the  match  is  successful.  A  literal  instructs  the 
translator  to  output  the  literal  (possibly  conditionally)  to  the  MCR 
command  line  and  the  translator  succeeds  only  if  either  the  literal  is 
not  conditionalized  or  the  conditionals  are  satisfied. 

The  following  is  an  example  of  a  parser  table  (PT)  for  the  DCL  ASSIGN 
command . 

MML  NOTATION  for  PARSER  TABLE 


ASSIGN: : 

AND 

END 

'ASSIGN  <QUAL  0PTR=T>  $DEV  $DEV 

QUAL: 

AND 

END 

'/  QUALI 

QUALI : 

OR 

< ' LOCAL, 4> 

OR. 

< ' LOGIN , 4> 

OR. 

< 'GLOBAL, 2> 

OR. 

END 

TERM 

TERM: 

AND 

END 

'TERMINAL:  <' TERMINAL , 4> ' : 
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The  following 

is  an 

command . 

MML 

ASN:  : 

AND 

END 

LAUQ : 

OR 

OR. 

OR. 

END 

MRET: 

AND 

END 

These  examples 

show 

MML  NOTATION  for  TRANSLATOR  TABLE 


1 ASN  $DEV  '=  $DEV  <LAUQ  OPTR=T> 

'/LOGIN 
'  /GBL 
MRET 


'/TERM=  $DEV 


e  first  two  steps  you  must  follow  in  creating 
the  tables  for  the  DCL  ASSIGN  command.  The  last  step  is  to  express 
the  mapping  of  the  syntax  elements  in  the  PT  to  the  syntax  elements  in 
the  TT.  This  mapping  provides  the  information  that  the 
parser/translator  process  needs  to  construct 
command  line 


a  particular  MCR  ASN 
given  a  particular  DCL  ASSIGN  command  line.  The 
following  section  describes  how  to  express  this  mapping. 


12.8  MAPPING  DCL  TO  MCR 

The  mapping  of  a  given  DCL  command  line  to  the  equivalent  MCR  command 
line  is  accomplished  in  the  IFORM.  The  parser  processes  mapping 
information  and  records  it  in  the  IFORM.  The  translator  searches  the 
IFORM  for  mapping  information  and  then  generates  the  MCR  command  line. 

Mapping  information  is  expressed  in  MML  with  the  "MAP=n"  attribute. 
MAP  takes  one  or  two  values.  The  first  value  is  called  the  primary 
mapping  number.  The  second  value  is  called  the  secondary  mapping 
number.  If  you  need  only  the  primary  mapping  number,  specify  it  in 
the  following  form: 

MAP=n 


If  you  need  to  specify  both  mapping  numbers,  which  is  allowed  only  in 
a  TT,  or  if  you  need  to  specify  only  the  second  number,  then  enclose 
the  numbers  in  angle  brackets  and  separate  them  with  a  comma  in  the 
following  form: 

MAP=<n ,n>  or  MAP=<,n> 

To  associate  the  MAP  attribute  with  a  syntax  element,  enclose  the 
syntax  element  and  the  MAP  attribute  in  angle  brackets  as  follows: 

<syntax-element  MAP=n> 

To  map  a  DCL  syntax  element  in  a  PT  to  an  MCR  syntax  element  in  the 
corresponding  TT,  use  MAP  with  the  same  mapping  number  for  both  syntax 
elements . 

For  example,  in  the  ASSIGN  command,  the  DCL  qualifier  "/GLOBAL"  maps 
to  the  MCR  qualifier  "/GBL".  That  is,  when  the  DCL  qualifier 
/GLOBAL"  is  input  (as  part  of  the  DCL  command  line),  the  MCR  switch 
/GBL"  is  output  (as  part  of  the  MCR  command  line) . 
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The  following  expresses  this  mapping  in  MML  notation  and  illustrates 
the  use  of  the  primary  MAP  number. 

QUAL:  OR  < 1 /GLOBAL  MAP=1>  ... 

END 

LAUQ :  OR  C'/GBL  MAP=1>  ... 

END 

MML  macros  at  QUAL:  define  DCL  syntax.  MML  macros  at  LAUQ:  (QUAL 

spelled  backwards)  define  the  corresponding  MCR  syntax.  When  the 
parser  reaches  QUAL: ,  it  tries  to  match  the  literal  "/GLOBAL”  to  the 
input  (DCL)  command  line.  If  the  match  is  successful ,  then  the  parser 
queues  the  MAP  number  "PI”  (the  "P"  indicates  a  primary  mapping 
number)  to  the  IFORM  queue.  When  the  translator  reaches  LAUQ:,  it 
searches  the  IFORM  queue  for  the  MAP  number  "PI".  If  the  translator 
finds  the  MAP  number  "Pl"f  it  outputs  to  the  (forming)  MCR  command 
line  the  literal  "/GBL" .  If  the  translator  cannot  find  the  MAP  number 
in  the  IFORM  queue ,  it  does  not  use  the  syntax  element  (associated 
with  the  MAP  number)  in  the  translation. 

The  MAP  attribute  in  a  PT  can  associate  either  a  primary  or  a 
secondary  mapping  number  with  a  syntax  element,  but  not  both. 

The  MAP  attribute  in  a  TT  can  associate  either  or  both  mapping  numbers 
with  a  syntax  element. 

Associating  a  primary  mapping  number  with  a  syntax  element  in  the  PT 
(by  means  of  the  MAP  attribute)  instructs  the  parser  to  queue  the 
primary  mapping  number  to  the  IFORM  queue. 

Associating  a  secondary  mapping  number  with  a  syntax  element  in  the  PT 
instructs  the  parser  to  queue  the  secondary  mapping  number  to  the 
IFORM  queue. 

In  both  cases  the  parser  queues  a  mapping  number  only  if  the  parser 
processes  the  associated  syntax  element  successfully. 

The  MAP  attribute  in  a  TT  instructs  the  translator  to  search  the  IFORM 
queue  for  a  mapping  number.  When  found,  the  translator  marks  the 
mapping  number  used  and  processes  the  associated  syntax  element. 

The  search  for  a  primary  mapping  number  differs  from  the  search  for 
secondary  mapping  numbers.  The  translator  searches  the  entire  IFORM 
queue  from  head  to  tail  to  find  primary  mapping  numbers.  The 
translator  limits  its  search  for  secondary  mapping  numbers,  however. 
The  translator  starts  its  search  for  secondary  mapping  numbers  at  the 
queue  element  containing  the  last  used  primary  mapping  number  and 
stops  the  search  at  the  next  queue  element  containing  a  primary 
mapping  number. 

Specifying  both  a  primary  and  a  secondary  mapping  number  in  the  TT 
(for  example,  MAP=<1,1>)  instructs  the  translator  to  search  the  entire 
IFORM  queue  for  the  specified  primary  mapping  number  such  that  the 
specified  secondary  mapping  number  follows  without  any  intervening 
primary  mapping  numbers.  The  secondary  mapping  number  qualifies  the 
primary  mapping  number.  The  primary  mapping  number  is  the  object  of 
the  search. 
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If  the  translator  finds  a  mapping  number  in  the  IFORM  queue r  the 
translator  processes  the  associated  syntax  element.  If  the  translator 
fails  to  find  the  mapping  number ,  the  processing  of  the  associated 
syntax  element  fails.  When  the  translator  finds  a  mapping  number  and 
successfully  processes  the  associated  syntax  element,  the  translator 
marks  as  used  the  queue  element  containing  the  found  mapping  number. 
A  used  mapping  number  can  no  longer  be  found.  This  prevents  infinite 
loops  in  the  TT  without  requiring  the  specification  of  termination 
conditions. 

A  MAP  attribute  can  be  specified  in  both  the  PT  and  the  TT  without 
associating  it  with  a  syntax  element  as  follows: 

<MAP=n> 

If  you  specify  this  attribute  as  an  argument  to  an  AND  or  OR  macro  in 
a  PT ,  the  parser  assumes  a  null  syntax  element.  A  null  syntax  element 
always  succeeds. 

If  you  specify  a  null  syntax  element  in  a  TT ,  the  translator  (after 
finding  the  queue  element  containing  the  mapping  number)  checks  to  see 
if  a  character  buffer  is  attached  to  the  queue  element.  If  a 
character  buffer  is  attached,  then  the  translator  copies  the  contents 
of  the  buffer  to  the  MCR  command  line  buffer.  If  a  character  buffer 
is  not  attached,  then  the  translator  (like  the  parser)  assumes  a  null 
syntax  element  (which  always  succeeds). 

The  parser  attaches  the  character  buffer  to  the  queue  element.  The 
COP  attribute  instructs  the  parser  to  create  the  character  buffer  and 
copy  the  text  parsed  by  the  associated  syntax  element  to  the  character 
buffer  (See  Section  12.10  for  details  on  the  COP  attribute). 

Thus,  mapping  starts  in  the  parser  process  when  the  parser  queues 
mapping  numbers  to  the  IFORM  queue  as  it  successfully  processes  syntax 
elements  that  have  associated  MAP  attributes. 

Mapping  is  completed  in  the  translator  process,  when  the  translator 
detects  mapping  numbers  in  the  IFORM  queue  and  translates  the  syntax 
elements.  Note  that  the  translator  does  not  output  a  syntax  element 
that  has  a  MAP  attribute  associated  with  it  unless  (1)  the  translator 
first  finds  the  mapping  number  in  the  /FORM  queue,  and  (2)  the  mapping 
number  has  not  been  previously  used. 

Here  is  an  example  of  a  complete  command  table  (with  DCL-MCR  mapping) 
for  the  DCL  ASSIGN  command. 

ASSIGN  MML  NOTATION  FOR  PARSER  TABLE 


ASSIGN: : 

AND 

END 

'ASSIGN  <QUAL  OPTR=T>  <$DEV  MAP=1>  <$DEV  MAP=2> 

QUAL: 

AND 

END 

'/  QUALI 

QUALI : 

OR 

< ' LOCAL, 3> 

OR. 

<’ LOGIN, 3  MAP=3> 

OR. 

< 'GLOBAL, 2  MAP=4 > 

OR. 

END 

TERM 

TERM: 

AND 

END 

< ' TERMINAL , 4> '  <DEV  MAP=5> 
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ASN  MML  NOTATION  FOR  TRANSLATOR  TABLE 


ASN:  : 

AND 

END 

'ASN  <MAP=1>  '=  <MAP=2>  <LAUQ  OPTR=T> 

LAUQ : 

OR 

O /LOGIN  MAP=3> 

OR. 

<'/GBL  MAP=4> 

OR. 

END 

MRET 

MRET : 

AND 

END 

'/TERM=  <MAP=5> 

For  a  complete  description  of  the  MAP  attribute,  see  Section  12.10. 
For  information  on  related  attributes  see  the  discussions  of: 

DMAP,  NO,  COP,  OCOP,  TST ,  and  DIR 

The  parser  records  mapping  information;  the  translator  detects  the 
mapping  information.  The  following  section  presents  IFORM,  the 
dynamic  data  structure  that  passes  mapping  information  from  the  parser 
to  the  translator. 


12.9  THE  INTERMEDIATE  FORM  (IFORM) 

The  IFORM  contains  the  essential  information  (extracted  from  the  input 
DCL  command  line)  that  the  translator  needs  to  construct  the  MCR 
command  line.  The  IFORM  consists  of  three  data  structures:  the 
queue,  the  character  buffers,  and  the  general  bit-mask  words. 


NOTE 


To  display  the  IFORM  for  a  given  DCL 
command,  use  SET  DEBUG/FULL. 


The  parser  creates  the  IFORM  queue  when  it  successfully  processes 
syntax  elements  with  MAP  attributes.  Each  time  the  parser 
successfully  processes  a  MAP  attribute,  it  queues  the  mapping  number 
to  the  IFORM  queue. 

The  parser  creates  a  character  buffer  when  a  syntax  element  has  both 
MAP  and  COP  attributes.  The  parser  attaches  the  character  buffer  to 
the  queue  entry  that  contains  the  mapping  number.  The  character 
buffer  contains  the  text  parsed  during  the  processing  of  the 
associated  syntax  element. 

A  syntax  element  with  a  COP  attribute  and  no  MAP  attribute  instructs 
the  parser  to  copy  the  text  parsed  to  the  last  queued  mapping  number 
(creating  and  attaching  the  character  buffer  if  neccessary) . 

The  general  bit-mask  words  are  two  words  used  as  a  set  of  32  flags. 
The  parser/translator  process  attaches  no  meaning  to  the  flags,  but 
MML  provides  a  set  of  attributes  to  set  flags,  clear  them,  test  if  the 
flags  are  set,  and  test  if  the  flags  are  clear.  You  can  use  the  flags 
to  check  for  contradictory  syntax.  In  addition,  use  the  flags  to  pass 
information  from  the  parser  to  the  translator.  For  example,  set  a 
flag  during  the  parser  process  if  a  DCL  qualifier  is  seen  and  detect 
the  set  flag  during  the  translator  process,  generating  the  equivalent 
MCR  switch. 
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The  translator  searches  the  IFORM  queue  for  mapping  numbers.  If  the 
translator  finds  the  mapping  numbers,  it  processes  the  syntax 
elements.  If  the  translator  cannot  find  the  mapping  numbers,  then  the 
syntax  elements  fail. 

If  a  MAP  attribute  is  specified  without  an  associated  syntax  element 
as  follows: 

<MAP=n> 

the  translator  first  finds  the  queue  element  containing  the  mapping 
number  and  then  examines  the  queue  element  for  a  character  buffer 
attached  by  means  of  the  COP  attribute.  If  the  translator  finds  an 
attached  character  buffer,  it  copies  the  contents  of  the  buffer  to  the 
MCR  command  line  buffer.  If  the  translator  cannot  find  an  attached 
buffer,  it  assumes  a  null  syntax  element  (which  always  succeeds). 

Use  the  following  attributes  (in  the  PT)  to  direct  the  parser  in  the 
creation  of  the  IFORM: 


MAP=n 

MAP=<,n> 

(map) 

DMAP=n 

DMAP=< , n> 

(map  unless  duplicate  exists) 

COP=T 

OCOP=T 

(copy,  or  copy  optional  input) 

BS=n 

BS=<,n>  BS=<n,n> 

(set  bit  in  mask  word) 

BC=n 

BC=<,n>  BC=<n,n> 

(clear  bit  in  mask  word) 

NO=T 

(repeats  for  negative  form  of 

syntax  element) 

Use 

the 

the  following  attributes  (in 
examination  of  the  IFORM: 

the  TT)  to  direct  the  translator  in 

MAP=n 

MAP=< , n>  MAP=<n ,n> 

(unmap) 

BST=n 

BST=< , n>  BST=<n ,n> 

(test  for  bit  set  in  mask  word) 

BCT=n 

BCT=< , n>  BCT=<n,n> 

(test  for  bit  clear  in  mask  word) 

TST=T 

(test  for  mapping  number,  do  not 
mark  as  used) 

DIR=T 

(search  IFORM  in  reverse  direction) 

For 

details 

on  these  attributes, 

see  Section  12.10. 

For 

example , 

if  the  input  command 

line  is: 

ASSIGN  DK1 :  SY: 


then  the  IFORM  would  be: 

Queue  Character  Buffer 


PI 

DK1 : 

P2 

SY: 
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If  the  input  command  line  is: 

ASSIGN/LOGIN/T : TT12 :  DK1 :  SY: 
then  the  I FORM  would  be: 

Queue  Character  Buffer 


P3 

P5 


PI 


P2 


TT12 : 


DK1 : 


SY: 


12.10  ATTRIBUTES  OF  SYNTAX  ELEMENTS 

Attributes  associate  characteristics  with  literal  and  nonliteral 
syntax  elements.  The  parser/translator  processes  attributes  either 
before  or  after  it  processes  the  associated  syntax  elements  (depending 
on  the  attribute) .  The  processing  of  attributes  can  influence  the 
processing  of  the  associated  syntax  elements. 

Here  is  the  format  for  specifying  attributes  as  part  of  an  argument  to 
an  AND  or  OR  macro: 


<'literal  KEY=value  KEYl=value  ...> 
or 

<label  KEY=value  KEYl=value  ...> 


where 

literal  Literal  (ASCII)  string 

label  Nonliteral  (address  of  an  AND  or  OR  macro) 

KEY  Attribute  keyword  identifying  the  attribute 

value  Value  assigned  to  the  attribute 

Note  the  use  of  the  angle  brackets  "<"  and  ">".  Use  these  MACRO-11 
symbols  to  indicate  that  everything  enclosed  is  considered  as  one 
argument  (when  expanding  macros) .  Do  not  confuse  these  MACRO-11  angle 
brackets  with  the  angle  brackets  used  to  indicate  nonliterals  in 
metalanguage  notation. 


12.10.1  AND 

AND  allows  you  to  extend  a  syntax  element  by  specifying  a  nonliteral 
that  is  ANDed  to  the  syntax  element.  The  primary  function  of  AND  is 
to  allow  OR  logic  to  be  mixed  with  AND  logic.  Assign  a  nonliteral  to 
the  AND  attribute  as  follows: 

AND=label 


where 


label  Nonliteral  address  of  an  AND  or  OR  macro 
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AND  instructs  the  parser/translator  to  process  the  AND  or  OR  macro 
that  the  label  (the  nonliteral)  addresses  in  addition,  to  processing 
the  syntax  element  with  which  the  AND  attribute  is  associated. 

For  example,  in  the  following  MML  definition  for  QUAL,  the  second 
syntax  element  defines  the  structure  "FILE : <f i lespec> " : 


QUAL: 

OR 

'BRIEF 

OR. 

< ' FILE  AND=FNAME> 

OR. 

END 

'FULL 

FNAME : 

AND 

END 

':  $FILE 

There  are  three  syntax  elements  in  this  structure: 
FILE 
and 


and 

<f ilespec> 

The  literal  " : "  and  the  nonliteral  <filespec>  connect  to  the  literal 
"FILE"  by  means  of  the  AND  attribute.  The  parser/translator  processes 
all  three  elements  as  one  element  to  the  OR  macro  by  definition  of  the 
AND  attribute. 


12.10.2  BC  and  BS 

BC  (Bit  Clear)  and  BS  (Bit  Set)  operate  on  two  global  bit-mask  words. 

The  BC  attribute  instructs  the  parser/translator  to  clear  bits  in 
these  two  global  words. 

The  BS  attribute  instructs  the  parser/translator  to  set  bits  in  these 
two  global  words. 

Use  the  BCT  and  BST  attributes  to  test  these  bits.  See  next  section. 
The  format  for  these  attributes  is  as  follows: 

BC=n  or  BC=< ,  nl>  or  BC=<n,nl> 

BS=n  or  BS=<,nl>  or  BS=<n,nl> 

where 


n 

nl 


Bit  mask  specifying  bits  in  the  first  global  word 
Bit  mask  specifying  bits  in  the  second  global  word 


Specify  a  bit  mask  by  ORing  single  bit  specifications  with  the 
MACRO-11  symbol  "!".  The  symbols  Bl,  B2,...B32  are  predefined  to 
correspond  to  single  bit  specifications  for  each  bit  in  the  two  global 
words . 
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For  example,  BS=B1!B2!B5  means  to  set  bits  1,  2,  and  5  of  the  first 
global  word.  See  the  next  section  for  an  example  of  these  attributes 
in  use. 


12.10.3  BCT  and  BST 

BCT  (Bit  Clear  Test)  and  BST  (Bit  Set  Test)  test  the  status  of  bits  in 
the  two  global  bit-mask  words.  See  the  previous  section  for 
information  on  how  these  bits  are  set  or  cleared. 

The  BCT  attribute  instructs  the  parser/translator  to  test  whether  bits 
are  cleared. 

The  BST  attribute  instructs  the  parser/translator  to  test  whether  bits 
are  set. 

The  parser/translator  does  not  clear  the  two  global  bit-mask  words 
between  the  parse  and  the  translation.  You  can  use  these  words  as 
part  of  the  IFORM  to  pass  information  from  a  PT  to  a  TT. 


The  format 

for  these  attributes 

is  as  follows 

BCT=n 

or 

BCT=< , nl> 

or 

BCT=<n 

,nl> 

BST=n 

or 

BST=< , nl> 

or 

BST=<n 

,nl> 

where 

n 

Bit 

mask  specifying 

bits  in 

the 

first 

global 

word 

nl 

Bit 

mask  specifying 

bits  in 

the 

second 

global 

word 

For  example,  BST=< , B19 ! B31>  means  to  test  whether  bits  19  and  31  of 
the  second  global  bit-mask  word  are  set. 

The  following  example  illustrates  the  use  of  BS,  BC,  BST,  and  BCT: 


COPY: 

AND 

FILE  <FILE  0PTR=T>  QUA= 

:QUAL 

END 

FILE: 

OR 

OR. 

END 

<$NFIL  BS=B1 

$FILE 

BCT=B2 ! B3> 

QUAL: 

OR 

<’ INDEX  BS=B2 

BCT=B1!B3> 

OR. 

END 

C SEQUENTIAL  BS=B3 

BCT=B1!B2> 

In  this  example,  INDEX  and  SEQUENTIAL  are  qualifiers,  $NFIL  is  a 
predefined  syntax  element  that  is  a  file  specification  that  has  a  node 
name  prefixing  it,  and  $FILE  is  a  predefined  syntax  element  that  is  a 
conventional  file  specification  (without  a  node  name) .  The  example 
specifies  that  the  qualifiers  INDEX  and  SEQUENTIAL  are  contradictory, 
that  INDEX  and  $NFIL  are  contradictory,  that  SEQUENTIAL  and  $NFIL  are 
contradictory,  but  that  duplicates  of  each  are  not  contradictory.  The 
BS  attribute  instructs  the  parser  to  set  the  specified  bits  if  the 
processing  of  the  associated  syntax  elements  is  successful.  The  BCT 
instructs  the  parser  to  test  whether  the  specified  bits  are  clear. 
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If  the  tested  bits  are  set,  the  parser  does  not  process  the  associated 
syntax  elements.  Thus,  bits  are  set  to  remember  which  syntax  elements 
process  successfully,  and  bits  are  tested  to  determine  if  a 
contradiction  would  result  from  the  processing  of  syntax  elements. 

The  main  difference  between  the  BC,  BCT ,  BS,  and  BST  attributes  and 
CBM  (described  in  the  next  section)  is  that  CBM  always  prevents 
duplicate  syntax  as  well  as  contradictory  syntax,  but  CBM  cannot  pass 
information  from  the  parser  to  the  translator. 


12.10.4  CBM,  CCBM 

Use  CBM  (Contradictory  Bit  Mask)  to  prevent  the  parser  or  translator 
from  allowing  contradictory  syntax.  To  indicate  that  two  or  more 
syntax  elements  cannot  be  specified  in  the  same  command  line,  specify 
CBM  with  each  syntax  element.  Assign  a  bit  mask  as  the  value  to  CBM. 
Specify  the  same  bit  in  each  bit  mask  associated  with  each 
contradictory  syntax  element. 

CBM  conditionalizes  the  processing  of  the  associated  syntax  element. 
The  parser  uses  the  specified  bit  mask  to  set  bits  in  two  global 
words.  If  the  parser  detects  that  any  bits  specified  in  the  bit  mask 
are  already  set  in  the  two  global  words,  then  the  parser  assumes  a 
contradiction  and  the  syntax  element  fails.  This  also  means  CBM  does 
not  allows  duplicate  syntax  elements. 

Also  note  that  the  parser/translator  clears  the  two  global  words 
between  the  parse  and  the  translation.  You  cannot  use  CBM  to  pass 
information  from  a  PT  to  a  TT. 


The  format  of  the  CBM  attribute  is  as  follows: 


CBM=n  or  CBM=<,nl>  or  CBM=<n,nl> 


where 

n  Bit  mask  specifying  bits  in  the  first  global  word 

nl  Bit  mask  specifying  bits  in  the  second  global  word 

Specify  a  bit  mask  by  ORing  single  bit  specifications  with  the 
MACRO-11  symbol  " ! " .  The  symbols  Bl,  B2,...,  B32  are  predefined  to 
correspond  to  single  bit  specification.  For  example,  CBM=Bl!B2!B5 
specifies  bits  1,  2,  and  5  of  the  first  global  word,  and 
CBM=< ,B19!B31>  specifies  bits  19  and  31  of  the  second  global  word. 

The  following  example  illustrates  the  use  of  the  CBM  attribute: 


QUAL:  OR 

O LOCAL 

CBM=B 1 ! B2> 

OR. 

<’ LOGIN 

CBM=B2> 

OR. 

< 'GLOBAL 

CBM=B 1 > 

END 

The  example  specifies 

that  the 

literals  "LOCAL" 

and  "GLOBAL"  are 

contradictory,  and 

that  the 

literals  "LOCAL" 

and  "LOGIN"  are  also 

contradictory,  but  that  the  literals  "LOGIN"  and  "GLOBAL"  are  not. 
The  example  also  specifies  that  each  of  these  elements  can  be  used 
only  once. 
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CCBM  (Clear  Contradictory  Bit  Mask)  clears  the  bits  in  the  two  global 
words.  The  format  for  specifying  CCBM  is  identical  to  the  format  that 
you  use  to  specify  the  CBM  attribute. 


12.10.5  COPf  OCOP 

COP  (COPy)  is  legal  only  in  a  PT  and  only  with  a  literal  syntax 
element.  COP  passes  a  literal  from  the  input  DCL  command  line  to  the 
I FORM.  The  translator  can  then  use  the  literal  in  the  MCR  command 
line.  The  parser  copies  the  literal  to  a  character  buffer  and 
attaches  it  to  the  mapping  number  last  queued.  If  you  specify  a  MAP 
attribute  with  the  COP  attribute,  the  mapping  number  (assigned  to  the 
MAP  attribute)  is  the  mapping  number  last  queued. 

The  format  of  the  COP  attribute  is  as  follows: 


COP=T 

For  example,  the  following  code  defines  a  terminal  specification: 

TERM:  OR  C'TT  C0P=T  AND=N> 

OR.  < 1 HT  COP=T  AND=N> 

OR.  < 1 VT  C0P=T  AND=N> 

OR.  <  ' TI  COP=T  AND=N> 

END 

N:  AND  <$ONUM , 0 , 3>  <':  OCOP=T> 

This  code  parses  and  copies  a  terminal  name  as  TT,  VT,  HT,  or  TI 
followed  by  an  octal  number  as  terminal  names.  (See  Section  12.11.1 
for  a  description  of  $ONUM,  which  defines  an  octal  number.)  The  OCOP 
attribute  assures  the  presence  of  the  terminating  colon  by  copying  it 
into  a  character  buffer  whether  or  not  the  user  inputs  one. 

To  instruct  the  translator  to  copy  the  character  buffer  to  the  MCR 
command  line,  specify  the  MAP  attribute  as  follows,  without  specifying 
an  associated  syntax  element: 

<MAP=n> 


When  the  translator  processes  a  MAP  attribute  that  has  no  associated 
syntax  element,  the  translator  examines  the  mapping  number  queue 
element  for  an  attached  character  buffer.  If  a  character  buffer  is 
found,  the  translator  copies  the  contents  of  the  character  buffer  to 
the  forming  MCR  command  line  buffer.  If  a  character  buffer  is  not 
found,  the  translator  assumes  a  null  syntax  element  (which  always 
processes  successfully) . 


OCOP  (Optional  COPy)  is  identical  to  COP  except  for  one  significant 
difference.  OCOP  instructs  the  parser  to  copy  the  literal  to  the 
IFORM  whether  or  not  the  processing  of  the  literal  succeeds.  That  is, 
the  literal  is  optional  and  always  succeeds  if  you  associate  OCOP  with 
i  t . 


The  following  illustrates  the  use  of  the  OCOP  attribute: 


DEV:  AND  <$ALF,2,2>  <$NUM,0,3>  <':  OCOP=T> 


The  MML  definition  defines  a  device  specification 
on  the  end  of  the  specification  is  optional, 
the  colon  to  the  output  MCR  command  line  whether 
found  a  colon  in  the  input  DCL  command  line. 


such  that 
The  transla 
or  not 


the 

tor 

the 


colon 

copies 

parser 
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12.10.6  DIR 

DIR  (DIRection)  is  legal  only  in  the  TT  and  only  when  you  specify  it 
with  a  MAP  attribute.  DIR  instructs  the  translator  to  search  the 
I FORM  queue  for  the  specified  mapping  number  in  reverse  order.  The 
normal  direction  of  the  search  is  from  the  head  of  the  queue  to  the 
tail  of  the  queue.  DIR  instructs  the  translator  to  search  the  I FORM 
queue  from  the  tail  to  the  head  of  the  I FORM  queue.  The  format  for 
DIR  is  as  follows: 


DIR=R 


The  following  example  of  a  TT  fragment  illustrates  the  use  of  the  DIR 
attribute : 


FILE: 

AND 

END 

<MAP=1 

DIR=R  <MORE  0PT=T> 

MORE: 

AND 

END 

A 

A 

V 

V 

FILE 

This  example  (recursively)  defines  the  structure  of  a  file 
specification  list,  where  the  file  specifications  are  mapped  to 
mapping  number  1.  Due  to  the  associated  DIR  attribute,  the  translator 
searches  for  the  mapping  numbers  in  reverse  order;  thus,  the  list  of 
file  specifications  is  output  to  the  MCR  command  line  in  reverse 
order . 


NOTE 

The  double  angle  brackets  are  necessary 
in  cases  where  the  contents  of  the 
brackets  include  a  MACRO-11  separator 
character  (in  this  case,  the  comma)  that 
is  to  be  treated  as  a  literal  by  MML. 


12.10.7  ERR 

ERR  (ERRor)  allows  you  to  associate  error  messages  with  syntax 
elements.  If  the  parser  or  the  translator  fails  to  process  a  syntax 
element,  and  the  syntax  element  has  ERR  specified,  then  the  parser  or 
translator  prints  the  error  message  specified  and  aborts  the  parse  or 
translation. 


The  format  for  ERR  is  as  follows: 


ERR=  ' string 


or 

ERR=label 

label:  ERROR  </string/> 
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For  example ,  to  specify  an  error  message  for  the  device  being 
assigned,  use  the  following  MML  notation  in  the  PT  for  the  ASSIGN 
command : 

AND  'ASSIGN  <QUAL  OPT=T>  <$DEV  ERR=< ' Inva 1 id  device>> 

If  the  parser  cannot  parse  the  input  DCL  command  line  text  that 
corresponds  to  the  device  specification  ($DEV) ,  the  parser  prints  the 
message  "ASSIGN  —  Invalid  device",  and  aborts  the  parse. 


12.10.8  HLP 

Use  HLP  (HeLP)  in  a  PT  only  to  associate  help  text  with  syntax 
elements  that  have  the  PRO  attribute  (Section  12.10.12)  specified. 
When  the  parser  is  prompting  and  a  "?"  character  is  input,  the  parser 
spawns  a  HELP  command.  The  parser  appends  the  text  specified  in  the 
HLP  attribute  to  the  HELP  command  "HELP  command"  where  "command"  is 
the  name  of  the  DCL  command  being  processed. 

The  format  of  the  HLP  attribute  is  as  follows: 

HLP=' string 

or 

HLP=label 

label:  HELP  </string/> 

where 

string  Appended  to  the  HELP  command 
label  Label  of  a  HELP  macro 

The  parser  appends  the  string  to  the  command  "HELP  command",  where 
"command"  is  the  name  of  the  current  command  being  processed.  For 
example,  if  you  specify  the  PT  for  ASSIGN  as: 

AND  <QUAL  OPTR=T>  <$DEV  PRO='Device?  HLP=< ' Log ical  name» 

and  the  user  types  a  "?"  in  response  to  the  prompt  "Device?",  the 
parser  forms  and  spawns  the  command  "HELP  ASSIGN  LOGICAL  NAME". 

This  requires  a  file  named  DC LAS SIGN .HLP  containing  the  necessary  help 
text.  For  the  format  of  the  HELP  file,  see  the  HELP  documentation  in 
the  RSX-1 1 M/M- PLUS  Command  Language  Manual  or  the  RSX-11M/M-PLUS  MCR 
Operations  Manual . 


12.10.9  MAP,  DMAP 

MAP  is  legal  in  both  the  PT  and  the  TT.  However,  the  parser  and  the 
translator  interpret  MAP  differently.  The  following  summarizes  the 
types  of  legal  MAP  attributes  in  a  parser  table. 

MAP=n  Instructs  the  parser  to  queue  the  specified  primary 

mapping  number  n  to  the  IFORM  queue  only  if  the 
associated  syntax  element  is  successfully  parsed. 
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MAP=<,nl>  Instructs  the  parser  to  queue  the  specified  secondary 

mapping  number  nl  to  the  IFORM  queue  only  if  the 

associated  syntax  element  is  sucessfully  parsed. 

Note  that  specifying  COP  with  MAP  in  a  PT  instructs  the  parser  to 
create  and  attach  a  character  buffer  to  the  mapping  number,  and  copy 
the  text  parsed  by  the  associated  syntax  element  to  the  attached 
character  buffer.  See  Section  12.10.5,  which  describes  COP,  for 
additional  details . 

The  following  summarizes  the  types  of  legal  MAP  attributes  in  a 

translator  table. 

MAP=n  Instructs  the  translator  to  search  the  IFORM  queue 

from  head  to  tail  for  the  specified  primary  mapping 
number  n.  If  found,  the  translator  places  the  element 
in  the  MCR  command  line.  If  not  found,  nothing 
happens . 

MAP=< , nl>  Instructs  the  translator  to  search  the  IFORM  queue  for 

the  secondary  mapping  number  nl.  Since  the  object  of 
the  search  is  a  secondary  (not  primary)  mapping 
number,  the  translator  does  not  search  the  entire 

IFORM  queue.  The  translator  starts  searching  at  the 

last  used  primary  mapping  number  and  stops  the  search 
at  the  next  primary  mapping  number.  If  the  secondary 
mapping  number  is  found,  then  the  associated  syntax 
element  is  processed;  otherwise,  nothing  happens. 

MAP=<n ,nl>  Instructs  the  translator  to  search  the  IFORM  queue 

from  head  to  tail  for  the  specified  primary  mapping 
number  n.  If  found,  the  translator  searches  for  the 
specified  secondary  mapping  number  nl.  If  found,  the 
associated  syntax  element  is  processed.  If  not  found, 
another  occurrence  of  primary  mapping  number  n  is 
sought.  If  another  instance  of  primary  mapping  number 
n  is  found,  then  the  translator  looks  again  for  the 
specified  secondary  number  nl.  This  search  process 
continues  until  either  all  primary  mapping  numbers  n 
have  been  found  and  none  of  them  have  a  secondary 

mapping  number  nl  after  them,  or  until  a  primary 
mapping  number  n  is  found  that  does  have  a  secondary 
mapping  number  nl  after  it. 

If  you  specify  a  MAP  attribute  in  a  TT  without  specifying  an 

associated  syntax  element,  the  translator  examines  the  queue  element 
containing  the  specified  mapping  number  for  an  attached  character 

buffer.  If  the  translator  finds  an  attached  character  buffer,  the 
translator  copies  the  contents  of  the  buffer  to  the  forming  MCR 

command  line  buffer.  If  the  translator  does  not  find  an  attached 
character  buffer,  the  translator  assumes  a  null  syntax  element  (which 
always  processes  successfully) . 

To  allow  additional  flexibility  in  the  search  for  secondary  mapping 
numbers,  the  translator  supports  the  following  additional  formats  for 
specifying  the  MAP  attribute  in  a  TT. 

MAP=<X , nl >  Instructs  the  translator  to  search  the  IFORM  queue 

from  head  to  tail  for  the  specified  secondary  mapping 
number  nl.  If  found,  the  translator  processes  the 

associated  syntax  element.  If  not  found,  the 
associated  syntax  element  fails  to  process.  The 

keyword  "X"  identifies  this  MAP  attribute  as  an 
unconditional  search  for  a  secondary  mapping  number. 
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MAP=<Xl,nl>  Instructs  the  translator  to  seach  the  IFORM  queue  for 

the  secondary  mapping  number  nl.  The  keyword  "XI" 
instructs  the  translator  to  limit  the  search  of  the 
queue  as  follows.  The  search  is  started  at  the  head 
of  the  queue  and  proceeds  until  the  first  primary 
mapping  number  is  detected.  If  the  secondary  mapping 
number  nl  is  not  found,  then  another  search  is 
conducted.  The  second  search  looks  for  the  secondary 
mapping  number  nl  such  that  it  follows  a  negative 

primary  mapping  number.  If  found,  the  translator 
processes  the  associated  syntax  element.  If  not 
found,  nothing  happens. 

Note  that  you  use  the  "X"  MAP  attribute  to  search  for  a  secondary  like 
a  primary  (that  is,  unconditionally)  and  the  "XI"  MAP  attribute. to 
search  for  floating  command  qualifiers.  For  information  on  floating 
command  qualifiers  see  Section  12.10.13,  which  describes  QUA. 

When  the  translator  finds  a  mapping  number  and  processes  the 

associated  syntax  element,  the  translator  marks  the  mapping  number  as 
used.  A  used  mapping  number  cannot  be  found  again  by  the  translator. 
Thus  marking  mapping  numbers  used  prevents  infinite  loops  in  the  TT 
without  the  need  to  specify  termination  conditions.  To  override  the 
marking  of  mapping  numbers,  use  TST.  To  reset  all  marked  mapping 
numbers,  use  the  $RESET  predefined  syntax  element.  (This  is  useful 
for  generating  multiple  MCR  commands  by  means  of  the  $NEW  predefined 
syntax  element.) 

DMAP  (duplicate  map)  is  identical  to  MAP  in  most  ways.  However,  it  is 
only  allowed  in  a  PT.  DMAP  instructs  the  parser  not  to  queue  the 

mapping  number  to  the  IFORM  queue  if  the  same  mapping  number  is 

already  present  in  the  IFORM  queue.  If  the  parser  does  not  queue  the 
mapping  number,  then  the  syntax  element  that  MAP  is  associated  with 
fails  to  process.  Thus,  the  DMAP  attribute  can  prevent  duplicate 
syntax . 

For  additional  information  on  the  use  of  the  MAP  attribute,  see  the 
Section  12.8,  Mapping  DCL  to  MCR. 

The  following  example  shows  the  use  of  primary  mapping  numbers  with 
predefined  syntax  elements. 

DCL  filespecs,  device  specifications,  numerals,  and  so  forth,  map  to 
themselves.  That  is,  when  a  filespec,  device  specification,  numeral, 
and  so  forth,  is  input,  the  same  filespec,  device  specification, 
numeral,  and  so  forth,  is  output.  Here  is  an  example  of  how  a 
terminal  device  specication  maps  to  itself. 

Parser  Table 

TERM:  AND  'TERMINAL:  <$DEV,MAP=2> 

END 

Translator  Table 

MRET :  AND  ' TERM=  <MAP=2> 

END 

The  parser  table  specifies  at  label  TERM:  If  the  input  command  line 
matches  a  device  specification  ($DEV) ,  then  queue  mapping  number  P2  to 
the  IFORM  queue,  attach  a  character  buffer  to  this  queue  element,  and 
copy  the  device  specification  to  the  attached  character  buffer.  The 
translator  table  specifies  at  label  MRET:  If  P2  is  in  the  IFORM 

queue,  then  output  the  contents  of  any  attached  buffer  to  the  forming 
MCR  command  line. 
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The  following  example  illustrates  the  use  of  secondary  mappings. 

When  translating  the  DCL  MACRO  command  to  the  MCR  MAC  command,  it  is 
nessessary  to  determine  which  (if  any)  input  filespec  has  the 
qualifier  /LIST  on  it.  That  is,  the  translator  must  be  able  to 
determine  (by  means  of  information  in  the  TT)  that  the  filespec  "C"  in 
the  DCL  command  line  "MACRO  A, B , C/LIST , D”  has  the  /LIST  qualifier  on 
it.  The  I FORM  must  map  the  DCL  filespec  that  has  the  /LIST  qualifier 
on  it  to  the  right  position  in  the  MCR  command  line. 

The  mapping  can  more  easily  be  understood  from  the  viewpoint  of  the 
translator.  The  translator  generates  the  MCR  MAC  command  from  left  to 
right.  When  the  translator  reaches  the  position  in  the  output  MCR 
command  line  where  the  list  file  must  be  placed,  the  translator  looks 
in  the  I FORM  queue  for  the  mapping  number  that  represents  the  filespec 
with  the  /LIST  qualifier  on  it.  Since  the  filespec  and  qualifier  are 
two  distinct  syntax  elements,  there  are  two  mapping  numbers  in  the 
I FORM  queue  to  represent  them.  Also,  since  the  I FORM  queue  is  a 
linear  data  stucture  (and  not  a  tree) ,  a  means  of  associating  the 
/LIST  qualifier  with  the  filespec  is  needed. 

To  express  an  association  between  elements  in  the  IFORM  queue,  use 
primary  and  secondary  mapping  numbers.  Secondary  mapping  numbers 
(such  as  SI)  have  meaning  only  as  related  to  primary  mapping  numbers 
(such  as  PI) . 

The  following  MML  notation  expresses  this  mapping  and  illustrates  the 
use  of  primary  and  secondary  mappings. 

Parser  Table 


AND 

END 

FILES:  AND 

END 

MORE:  AND 

END 


AND 

END 

LST :  AND 

END 
SELIF: 


'MACRO  FILES 

<$FILE  MAP=1 >  < ' /LIST  OPT=T  MAP=<,1>>  <MORE  OPT=T> 
<<',>>  FILES 

Translator  Table 

'MAC  <0B J  OPT=T>  <LST  OPT=T>  '=  SELIF 
«'  ,>>  <MAP=<1 , 1» 


It  is  possible  when  parsing  (due  to  the  recursive  definition  of  FILES) 
to  queue  to  the  IFORM  queue  identical  map  numbers  ("PI")  that 
represent  the  input  filespecs.  The  only  means  of  distinguishing  the 
"PI"  map  numbers  is  by  their  lef t-to-r ight  positioning.  For  the 
translator  to  find  the  "PI"  map  number  that  represents  the  filespec 
with  the  /LIST  on  it,  the  translator  has  to  find  the  "PI"  map  number 
that  is  followed  by  the  "SI"  map  number  such  that  there  are  no 
intervening  "Pn"  map  numbers.  In  MML,  to  instruct  the  translator  to 
perform  such  a  search,  use  the  argument  "<MAP=<1 , 1>>" ,  as  specified  at 
label  LST. 

Remember  that  if  a  reference  is  made  to  a  secondary  map  number  without 
specifying  a  primary  map  number,  then  the  translator  looks  for  a 
secondary  map  number  that  is  associated  with  the  last  used  primary  map 
number . 
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12.10.10  NO 

NO  is  allowed  only  in  a  PT.  NO  instructs  the  parser  to  process  either 
a  literal  "NO"  or  a  literal  before  it  processes  the  associated 
literal.  The  NO  attribute  is  legal  only  when  associated  with  a 
literal  syntax  element.  The  format  for  the  NO  attribute  is: 


NO=t 


If  you  specify  a  MAP  with  a  NO,  the  parser  queues  two  different 
mapping  numbers.  If  the  parser  does  not  process  either  the  "NO"  or 
the  the  parser  queues  the  mapping  number  assigned  to  MAP.  If  the 
parser  does  process  either  the  "NO"  or  the  "-",  the  parser  increments 
the  mapping  number  by  one  before  it  queues  the  mapping  number. 

The  following  illustrates  the  use  of  NO: 

OR  < ' LIST  MAP=10 .  NO=T> 

In  this  example,  the  parser  attempts  to  parse  either  NOLIST,  -LIST,  or 
LIST.  If  LIST  is  parsed,  the  parser  adds  the  mapping  number  10  to  the 
I FORM  queue.  If  either  NOLIST  or  -LIST  is  parsed,  the  parser  queues 
the  mapping  number  11. 


12.10.11  OPT,  OPTR 

Use  OPT  (OPTional)  to  indicate  that  a  syntax  element  is  not  required. 
You  can  use  OPT  in  both  the  PT  and  the  TT.  The  parser  and  the 
translator  interpret  OPT  identically. 

The  format  for  OPT  is  as  follows: 

OPT=T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command,  use  the  following  MML  notation: 

AND  'ASSIGN  <QUAL  OPT=T>  ... 

The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  at 
label  QUAL.  If  the  parser  cannot  process  a  syntax  element  in  an  AND 
macro,  the  failure  implies  the  failure  of  the  AND  macro.  The  OPT=T 
attribute  tells  the  parser  to  ignore  the  failure  and  continue 
processing  the  AND  macro  with  the  next  ( lef t-to-r ight)  argument  to  the 
AND  macro. 

Use  OPTR  (OPTional  Repeat)  in  the  same  way  to  indicate  that  a  syntax 
element  is  not  required.  In  addition,  use  OPTR  to  indicate  that  the 
syntax  element  can  be  used  repeatedly  in  the  parse/translation  until  a 
failure  results.  In  other  words,  the  presence  of  OPTR  indicates  that 
the  syntax  element  can  be  used  to  parse  or  translate  syntax  from  zero 
to  an  infinite  number  of  times. 

The  format  for  OPTR  is  as  follows: 

OPTR=T 

For  example,  to  specify  that  qualifiers  (label  QUAL)  are  optional 
syntax  in  the  ASSIGN  command  and  that  the  qualifiers  can  be  used 
repeatedly  in  the  input  command  line,  use  the  following  MML  notation: 

AND  'ASSIGN  <QUAL  0PTR=T>  ... 
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The  parser  goes  to  label  QUAL  and  processes  the  syntax  defined  there. 
If  a  syntax  element  in  an  AND  macro  fails,  the  failure  cannot  be  used 
in  the  parse,  implies  the  failure  of  the  AND  macro.  The  OPTR=T 
attribute  tells  the  parser  to  ignore  failure  and  to  continue 
processing  the  AND  macro  with  the  next  (left-to-right)  argument  to  the 
AND  macro.  However,  if  and  while  the  syntax  defined  at  label  QUAL 
matches  the  input  command,  the  parser  uses  it  repeatedly. 

If  the  OPT  and  AND  attributes  are  used  in  the  same  syntax  element,  the 
OPT  modifies  the  AND.  That  is,  the  OPT  does  not  modify  the  entire 
syntax  element. 

For  example,  here  is  a  fragment  of  code  based  on  the  LINK  command 
translator  table.  The  TT  specifies  a  TKB  switch  that  can  be  specified 
with  or  without  arguments  attached. 


OR.  <’/PR  MAP=1  AND=PRIV  OPT=T> 

END 


PRIV:  AND  '  :  <MAP=3> 

END 

In  the  example ,  the  optional  argument  to  the  /PR  switch  is  attached  to 
mapping  number  3.  The  OPT  applies  to  AND=PRIV  and  not  to  the  whole 
syntax  element.  If  the  OPT  applied  to  the  entire  syntax  element,  then 
the  entire  OR  macro,  of  which  this  fragment  is  a  part,  would  always 
succeed . 


12.10.12  PRO 

Use  PRO  (PROmpt)  in  the  PT  to  associate  prompt  strings  with  syntax 
elements.  If  the  parser  detects  end-of-line  while  processing  a  syntax 
element  that  has  the  PRO  attribute  specified,  the  parser  prints  the 
prompt  string  specified,  and  suspends  itself  to  wait  for  more  input. 
The  parser  appends  any  input  received  to  the  input  DCL  command  line. 
PRO  is  legal  only  in  the  PT.  The  translator  does  not  prompt. 

The  format  of  PRO  is  as  follows: 

PRO='string 

or 

PRO=label 

label:  PROMPT  </string/> 

where 

string  ASCII  string  to  be  used  as  the  prompt  string 

label  (MACRO-11)  label  of  a  (MACRO-11)  PROMPT  macro 

Thus,  specify  the  prompt  string  directly  after  the  "="  symbol,  or  as 
the  argument  to  the  PROMPT  macro.  The  PROMPT  macro  allows  global 
prompt  strings,  which  conserve  space. 
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The  following  example  illustrates  the  use  of  PRO: 

AND  <QUAL  OPTR=T>  <$DEV  PRO= ' Device?>  <$DEV  PRO=PRODEV> 

PRODEV:  PROMPT  </Logical  device?  /> 

The  command  requires  two  device  specifications  ($DEV) .  If  the  parser 
expects  the  first  $DEV  but  reaches  the  end  of  the  line,  then  the 
parser  prompts: 

Device? 

If  the  parser  expects  the  second  $DEV  but  reaches  the  end  of  the  linef 
then  the  parser  prompts: 

Logical  device? 


12.10.13  QUA 

Use  QUA  (QUAlifier)  to  specify  qualifiers.  You  can  specify  floating 
or  positional  qualifiers.  Floating  qualifiers  are  qualifiers  that  are 
legal  anywhere  in  the  input  DCL  command  line.  Positional  qualifiers 
are  qualifiers  that  are  legal  only  at  specific  positions  in  the  input 
DCL  command  line  or  output  MCR  command  line. 

The  positional  form  of  the  QUA  attribute  is  legal  in  both  a  PT  and  a 
TT.  The  floating  form  is  legal  only  in  a  PT. 

The  format  for  QUA  is  as  follows: 

QUA=label 


where 

label  Nonliteral  (address  of  an  AND  or  OR  macro) 

When  the  QUA  attribute  is  used  in  a  PT  and  the  parser  encounters  a 
slash  (/)  in  an  appropriate  location,  it  attempts  to  match  the  text 
following  the  slash  with  one  of  the  elements  of  the  AND  or  OR  macro  at 
the  specified  label.  If  an  end-of-line  is  encountered  after  the 
slash,  the  parser  issues  a  prompt.  If  an  illegal  qualifier  is  given, 
then  an  error  message  is  printed  and  the  parse  is  aborted.  The  list 
of  qualifiers  is  repeatedly  scanned  until  all  qualifiers  in  the  input 
command  line  have  been  parsed. 

To  specify  a  positional  QUA  attribute,  use  QUA  as  part  of  a  syntax 
element.  For  instance: 


AND 

END 

<’ ASSIGN, 3  QUA=QUAL>  $DEV  $DEV 

QUAL: 

OR 

< 'GLOBAL , 1> 

OR. 

<• LOCAL, 3> 

OR. 

< ' LOGIN , 3> 

OR. 

END 

TERM 

In  this  case,  any  qualifiers  (such  as  /GLOBAL)  must  immediately  follow 
"ASSIGN"  in  the  command  line.  (See  the  following  example  for  more 
details  on  how  the  QUA  attribute  works.) 
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To  specify  floating  qualifiers  use ,  QUA  as  a  separate  argument  to  an 
AND  macro ,  not  as  part  of  another  argument.  The  parser  attempts  to 
match  the  qualifiers  defined  at  the  label  before  and  after  it 
processes  each  argument  of  the  AND  macro.  That  is,  the  qualifiers 
float  before  and  after  each  syntax  element  defined  by  the  AND  macro. 
Furthermore,  the  parser  attempts  to  parse  the  floating  qualifiers 
after  any  prompts.  If  QUA  is  being  used  to  specify  floating 
qualifiers,  it  must  be  an  argument  to  an  AND  macro,  rather  than  an 
AND.  (extension)  macro.  The  floating-qualifier  form  of  QUA  is  legal 
only  in  a  PT. 

The  following  illustrates  the  floating-qualifier  form  of  QUA: 


QUAL: 


AND  'ASSIGN,  3  $DEV  $DEV  QUA=QUAL 

END 

OR  < ' LOCAL , 3> 

OR.  < ' LOGIN , 3> 

OR.  < 'GLOBAL , 1> 

OR.  TERM 

END 


The  label  QUAL  defines  the  allowable  qualifiers.  The  parser  checks 
for  the  qualifiers  before,  between,  and  after  the  $DEV  syntax 
elements.  Before  the  parser  transfers  parsing  control  to  the  OR  macro 
at  label  QUAL,  the  parser  attempts  to  parse  the  slash  "/"  character. 
Only  if  the  parser  successfully  parses  the  slash,  does  it  attempt  to 
parse  the  qualifiers  defined  at  label  QUAL.  If  the  parser  detects  the 
end  of  the  input  DCL  command  line  after  it  parses  a  slash  character, 
the  parser  prompts  for  more  input.  If  a  slash  is  detected  and  the 
qualifiers  defined  at  label  QUAL  fail  to  process,  the  parser  issues  an 
error  message  and  aborts  the  parse.  The  parser  repeatedly  attempts  to 
parse  the  qualifiers  until  it  no  longer  can  parse  a  slash  character. 


Thus,  using 
following : 

QUA 

in  the  previous  example  is  equivalent  to  the 

AND 

<QUAL  OPTR=T>  $DEV  <QUAL  OPTR=T>  $DEV  <QUAL  OPTR=T> 

END 

QUAL: 

AND 

'/  <QUAL1  PRO=' Qualifier?  ERR=< ' Illegal  qualifiers 

QUAL1 : 

OR 

<' LOCAL, 2> 

OR. 

< ' LOGIN , 2> 

OR. 

< 'GLOBAL , 1> 

END 

The  following  illustrates  the  use  of  the  QUA  attribute  in  a  TT. 

ASN : :  AND  <<'ASN  >>  <MAP=1>  '=  <MAP=2  QUA=LAUQ> 

END 

LAUQ:  OR  C'GBL  MAP=4> 

OR.  <' LOGIN  MAP=3> 

OR.  MRET 
END 

The  label  LAUQ  defines  the  MCR  switches  equivalent  to  the  DCL 
qualifiers.  The  translator  processes  QUA  just  as  does  the  parser. 
However,  instead  of  parsing  the  input  DCL  command  line  for  qualifiers, 
the  translator  uses  the  qualifiers  to  construct  the  equivalent  MCR 
command  line.  Remember  that  QUA  automatically  includes  slashes  before 
each  switch. 


12-38 


THE  DCL  TASK 


12.10.14  TST 

TST  is  legal  only  in  a  TT  and  only  when  specified  with  MAP.  TST 
instructs  the  translator  not  to  mark  a  mapping  element  used  in  a 
translation  as  having  been  used. 

The  format  of  the  TST  attribute  is  as  follows: 

TST=T 

The  following  illustrates  the  use  of  the  TST  attribute: 


MCRCOP :  OR 

<PIP 

MAP=1  TST=T> 

OR. 

<PIP 

MAP=2  TST=T> 

OR. 

<NFT 

MAP=3> 

END 

In  the  previous  example ,  the  OR  macros  instruct  the  translator  to 
process  the  nonliteral  PIP  if  either  mapping  numbers  1  or  2  are  in  the 
I FORM  queue ,  or  to  process  the  nonliteral  NFT  if  mapping  number  3  is 
in  the  I FORM  queue.  The  TST  attribute  associated  with  the  syntax 
element  PIP  instructs  the  translator  not  to  mark  mapping  numbers  2  or 
3  as  having  been  used.  This  allows  the  syntax  defined  at  label  PIP  to 
use  these  mapping  numbers  also. 


12.11  PREDEFINED  SYNTAX  ELEMENTS 

Predefined  syntax  elements  (PSEs)  are  syntax  elements  defined  for  use 
by  all  DCL  command  tables.  PSE  names,  by  convention,  are 
distinguished  from  local  category  names  by  having  a  "$"  as  their  first 
character . 


NOTE 

If  the  syntax  of  a  command  does  not 
match  that  of  a  predefined  syntax 
element,  then  the  parse  fails.  Several 
PSEs  have  two  forms,  one  ending  with  an 
"E"  and  one  not,  such  as  $NOD  and  $NODE, 
$FI L  and  $FILE ,  $DEV  and  $DEVE ,  and  $UIC 
and  $UICE .  The  form  ending  in  "E" 
produces  an  error  message  before 
aborting  the  parse.  The  shorter  form 
does  not.  Use  the  shorter  form  when 
defining  optional  syntax. 


The  following  list  briefly  defines  the  PSEs.  Note  that  some  PSEs 
require  arguments.  Specify  the  required  arguments  in  the  order  shown 
and  enclose  the  PSE  and  the  arguments  in  angle  brackets  to  identify 
the  PSE  and  arguments  as  one  argument  to  the  MACRO-11  assembler. 


12.11.1  Basic  Data  Types 

The  following  list  of  PSEs  define  basic  data  types  in  MML.  You  can 
use  them  only  in  a  PT.  The  parser  copies  to  an  I FORM  character  buffer 
the  text  in  the  input  DCL  command  line  that  fits  the  structure  defined 
by  the  PSE.  The  buffer  is  attached  to  the  last  queued  mapping  number 
and  can  be  accessed  by  the  translator  for  use  in  constructing  the 
equivalent  MCR  command  line. 
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$NUM,A1,A2 


$DNUM,A1,A2 


$ONUM , A1 , A2 


$WONUM , A1 , A2 


$D0NUM,A1,A2 [.] 


$WDONUMf A1,A2 


$BNUM, Al, A2 


$ALF  ,  Al , A2 


$ALFN , Al , A2 


$WALFN  ,  Al , A2 


Defines  the  structure  or  syntax  of  a  numeric  string 
(0  through  9).  The  arguments  A1  and  A2  designate  the 
minimum  and  maximum  length,  respectively,  for  the 
numeric  string.  Additionally,  the  PSE  allows  an 
optional  decimal  point  on  the  end  of  the  string.  The 
decimal  point  is  not  copied  to  the  I FORM  character 
buffer . 

Defines  the  structure  or  syntax  of  a  decimal  numeric 

string  (0  through  9).  The  arguments  A1  and  A2 

designate  the  minimum  and  maximum  length, 

respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
IFORM  character  buffer  whether  or  not  it  is  specified 
in  the  input  DCL  command  line. 

Defines  the  structure  or  syntax  of  an  octal  numeric 

string  (0  through  7).  The  arguments  A1  and  A2 

designate  the  minimum  and  maximum  length, 

respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  $0NUM  or  the 

wildcard  character  The  arguments  A1  and  A2 

designate  the  minimum  and  maximum  length, 

respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  a  decimal  or  octal 
numeric  string  (0  through  9).  The  arguments  A1  and 
A2  designate  the  minimum  and  maximum  length, 
respectively,  for  the  numeric  string.  Additionally, 
the  PSE  allows  an  optional  decimal  point  on  the  end 
of  the  string.  A  decimal  point  is  copied  to  the 
IFORM  character  buffer  if  either  the  input  DCL 
command  line  or  the  parsed  string  contains  the 
characters  8  or  9. 

Defines  the  structure  or  syntax  of  $DONUM  or  a 
character.  The  arguments  A1  and  A2  designate  the 
minimum  and  maximum  length,  respectively,  for  the 
numeric  string. 

Defines  the  structure  or  syntax  of  a  binary  numeric 
string  (0  through  1) .  The  arguments  A1  and  A2 

designate  the  minimum  and  maximum  length, 

respectively,  for  the  numeric  string. 

Defines  the  structure  or  syntax  of  an  alphabetic 
string  (A  through  Z) .  The  arguments  A1  and  A2 

designate  the  minimum  and  maximum  length  for  the 
alphabetic  string . 

Defines  the  structure  or  syntax  of  an  alphanumeric 
string  (0  through  9  and/or  A  through  Z) .  The 

arguments  A1  and  A2  designate  the  minimum  and  maximum 
length  for  the  alphanumeric  string. 

Defines  the  structure  or  syntax  of  $ALFN  with  the 
additional  characters:  and  These 

characters  are  used  by  some  RSX-11M/M-PLUS  utilities 
as  wildcard  characters.  The  arguments  A1  and  A2 
designate  the  minimum  and  maximum  length  for  the 
alphanumeric  string. 
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$R50,A1,A2 

Defines  the  structure  or  syntax  of  a  Radix-50  string 
(0  through  9,  A  through  Z,  and  The 
arguments  A1  and  A2  designate  the  minimum  and  maximum 
length  for  the  Radix-50  string. 

12.11.2  Common  Command  Elements 

The  following  PSEs  define  parts  of  the  DCL  command  grammar.  You  can 
use  them  only  in  a  PT.  The  text  (except  for  $DATE)  parsed  from  the 
input  DCL  command  line  that  fits  the  structure  defined  by  the  PSE  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to  the  last 


queued  mapping 

number . 

$FIL 

Defines  the  structure  or  syntax  of  a  file 

specification.  Each  element  explicitly  included  in  the 
filespec  sets  a  bit  in  the  global  bit-mask  words. 
These  are: 

device  B28  filetype  B31 

UIC  B29  version  B32 

filename  B30 

These  bits  are  also  set  by  the  other  $FIL-based 
predefined  syntax  elements. 

$FILE 

Defines  the  structure  or  syntax  of  $FIL.  Add i tionally , 
if  the  parser  fails  to  process  $FILE ,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

$WFIL 

Defines  the  structure  or  syntax  of  $FIL.  Additionally , 
the  wildcard  characters:  and  "%"  are  allowed  as 
part  of  the  file  specification. 

$WFILE 

Defines  the  structure  or  syntax  of  $WFIL. 
Additionally ,  if  the  parser  fails  to  process  $WFILE , 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$NFIL 

Defines  the  structure  or  syntax  of  $WFIL  if  preceded  by 
a  DECnet  node  specification. 

$NFILE 

Defines  the  structure  or  syntax  of  $NFIL . 
Additionally ,  if  the  parser  fails  to  process  $NFILE , 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$IFIL 

Defines  the  structure  or  syntax  of  $FIL.  Additionally , 
the  indirect  file  indicator  "@n  must  prefix  the  file 
specification. 

$IFILE 

Defines  the  structure  or  syntax  of  $IFIL. 
Additionally f  if  the  parser  fails  to  process  $IFILE , 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$NOD 

Defines  the  structure  or  syntax  of  a  DECnet  node  name 
specification. 

$N0DE 

Defines  the  structure  or  syntax  of  $N0D.  Additionally f 
if  the  parser  fails  to  process  $NODEf  the  parser  issues 
an  error  message  and  aborts  the  parse. 
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$DEV 

Defines  the  structure  or  syntax  of  a  device 

specification. 

$DEVE 

Defines  the  structure  or  syntax  of  $DEV.  Add i t ionally , 
if  the  parser  fails  to  process  $DEVE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

$ODEV 

Defines  the  structure  or  syntax  of  $DEV.  Add  it ionally , 
the  character  " 2 ”  is  optional  syntax. 

$ODEVE 

Defines  the  structure  or  syntax  of  $ODEV. 
Additionally ,  if  the  parser  fails  to  process  $ODEVE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$UIC 

Defines  the  structure  or  syntax  of  a  UFD  specification. 

$UICE 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
if  the  parser  fails  to  process  $UICE,  the  parser  issues 
an  error  message  and  aborts  the  parse. 

$WUIC 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
the  wildcard  character  is  allowed  as  part  of  the 
UIC  specification. 

$WUICE 

Defines  the  structure  or  syntax  of  $WUIC. 
Additionally,  if  the  parser  fails  to  process  $WUICE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$OUIC 

Defines  the  structure  or  syntax  of  $UIC.  Additionally, 
the  characters  "[",  "l",  and  " , "  are  optional  syntax. 

$OUICE 

Defines  the  structure  or  syntax  of  $OUIC. 
Additionally,  if  the  parser  fails  to  process  $OUICE, 
the  parser  issues  an  error  message  and  aborts  the 
parse . 

$DATE 

Defines  the  structure  or  syntax  of  a  date 
specification.  A  date  specification  can  take  one  of 
two  forms:  mm/dd/yy  or  dd-mmm-yy.  $DATE  produces  the 
following  data  structures  in  the  IFORM  queue:  the  day 
is  attached  to  secondary  mapping  number  210,  the  month 
is  attached  to  secondary  mapping  number  211,  and  the 
year  is  attached  to  secondary  mapping  number  212.  The 
output  format  is  always  dd-mmm-yy  (with  the  first  three 
characters  of  the  month  name  spelled  out)  even  if  the 
slash  format  (with  the  number  of  the  month)  is  used. 

$DATE1 

For  commands  that  require  two  dates  (for  example,  SINCE 
and  THROUGH),  a  second  PSE  for  dates,  $DATE 1 ,  uses 
secondary  mapping  numbers  213,  214,  and  215  for  the 
day,  month,  and  year  respectively.  $DATE1  is  otherwise 
identical  to  $DATE • 

$TIME 

Defines  the  structure  or  syntax  of  a  time 
specification.  The  time  specification  is  of  the  form 
hh :mm [ : ss] . 
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12.11.3  Special  Parser  Elements 

You  can  specify  the  following  PSEs  only  in  a  PT. 

$ALL, label  Defines  the  syntax  or  structure  of  an  arbitrary  string 

of  characters.  $ALL  matches  all  characters  in  the 
command  line  ( lef t-to-r ight)  until  any  one  of  a  set  of 
specified  terminating  characters  is  detected.  The  set 
of  terminating  characters  are  specified  with  the 
TERMINATORS  macro.  The  label  is  a  label  on  the 
TERMINATORS  macro.  The  text  parsed  from  the  input  DCL 
command  line  that  fits  the  structure  defined  by  $ALL  is 
copied  to  an  IFORM  character  buffer  that  is  attached  to 
the  last  queued  mapping  number. 

Here  is  an  example  of  $ALL  with  the  TERMINATORS  macro: 


AND. 


<$ALL , EXCEPT> 


EXCEPT:  TERMINATORS  ' "  '  )  ']  $EOL 


$EOL 


$COP, 'lit 


$DSB 


$ESB 


$DDR 


This  example  allows  the  "f"  the  " ) " ,  and  the  "]  "  as 
terminators,  in  addition  to  the  $EOL  predefined  syntax 
element,  discussed  next. 

$EOL  is  used  to  parse  end-of-line  characters.  For 
instance,  in  the  previous  example,  a  carriage-return  or 
escape  would  also  be  acceptable  as  a  terminator. 

$COP  does  not  define  syntax.  $COP  instructs  the  parser 
to  copy  the  specified  literal,  'lit,  unconditionally  to 
an  IFORM  character  buffer.  The  IFORM  character  buffer 
is  always  attached  to  the  last  queued  mapping  number. 

$DSB  (disable  skip  blanks)  does  not  define  syntax. 
$DSB  instructs  the  parser  not  to  skip  blanks. 
Normally,  blanks  are  ignored.  $DSB  and  $ESB  must  be  in 
the  same  syntax  element,  such  as  AND  or  OR,  but  need 
not  be  on  the  same  line. 

$ESB  (enable  skip  blanks)  does  not  define  syntax.  $ESB 
restores  the  default  state,  which  is  to  ignore  blanks. 

For  example,  a  filespec  cannot  include  blanks.  The 
following  could  define  a  filespec: 

$DSB  $DEV  $UIC  <$ALFN,0,9>  <$ALFN,0,3>  <$ONUM,Of3>  $ESB 

(The  actual  filespec  definition  is  more  complex.  This 
is  only  an  example.) 

$DDR  does  not  define  syntax.  $DDR  instructs  the  parser 
to  disable  delimiter  recognition.  Delimiter 
recognition  is  enabled  by  default  and  instructs  the 
parser  to  ensure  that  all  literal  syntax  elements  have 
delimiting  characters  terminating  them.  $DDR  must  be 
used  on  the  same  line  with  $EDR •  See  the  next  example. 
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$EDR 


$SEP 

$OSEP 

$CSEP 

$COSEP 

$.FSEP 

$TERM 

$PROC 

$PRONC 

12.11.4 

You  can 
$NEW 

$RESET 

$FNAM 

$SY 


Enable  delimiter  recognition.  This  is  the  default 
case . 

For  example ,  the  following  line  allows  you  to  attach 
the  first  one  to  three  characters  to  one  mapping  number 
while  the  remainder  are  attached  to  another. 

C0M1 :  AND  $DDR  <$R50fl,3  MAP=1>  <$R50,0,7  MAP=2>  $EDR 

END 

Notice  that  no  delimiting  character  distinguishes  the 
two  strings,  and  that  the  second  string  may  be  null. 

$SEP  defines  the  colon  (:)  or  equals  (=) .  These  are 
used  as  separators  between  qualifiers  and  arguments. 

$OSEP  defines  an  optional  separator,  that  is  colon, 
equals,  or  null. 

$CSEP  is  the  same  as  $SEP,  but  additionally  copies  a 
colon  to  the  IFORM. 

$COSEP  is  the  same  as  $OSEP,  but  additionally  copies  a 
colon  to  the  IFORM  whether  anything  is  input  or  not. 

$FSEP  defines  the  comma  (,)  and  plus  (+)  as  filespec 
separators . 

$TERM  defines  a  terminal  specification  and  copies  it  to 
the  IFORM. 

$PROC  defines  a  processor  name  for  the  Queue  Manager  as 
either  a  device  name  followed  by  a  colon  or  six 
Radix-50  characters  followed  by  a  colon. 

$PRONC  defines  a  processor  name  for  the  Queue  Manager 
as  a  device  name  followed  by  a  colon  or  six  Radix-50 
characters  not  followed  by  a  colon. 


Special  Translator  Elements 


specify  the  following  PSEs  only  in  a  TT. 

Used  to  indicate  the  start  of  an  additional  MCR  command 
line.  $NEW  instructs  the  dispatcher  subprocess  of  the 
DCL  task  that  there  are  multiple  MCR  commands  that  must 
be  dispatched  serially. 

Used  to  reset  the  IFORM  queue.  Resetting  the  IFORM 
queue  allows  all  used  mapping  numbers  to  be  reused. 
$RESET  is  designed  to  be  used  with  $NEW  to  define 
multiple  MCR  commands. 

Used  to  specify  that  only  the  file  name  in  a  file 
specification  is  to  be  copied  to  the  MCR  command  line 
buffer  as  a  result  of  unmapping  a  mapped  file 
specification . 

Converts  the  assigned  device  for  SY:  to  ASCII  and 
appends  it  to  the  MCR  command  line;  for  example,  DB2 : . 
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$TI 

Converts  the  assigned  terminal  device  for  TIs  to  ASCII 
and  appends  it  to  the  MCR  command  line;  for  example , 
TT15 : . 

$CUIC 

Converts  the  current  UIC  for  the  user  to  ASCII  and 
appends  it  to  the  MCR  command  line;  for  example, 
[301,113] . 

$LUIC 

Converts  the  login  UIC  for  the  user  to  ASCII  and 
appends  it  to  the  MCR  command  line. 

12.11.5  Program  Control  Elements 

You  can  specify  the  following  PSEs  in  either  a  PT  or  a  TT. 


$JSR, A 

A  special  category  used  to  gain  control  of  the  CPU. 
The  argument  A  must  be  the  label  of  a  MACRO-11 
subroutine.  To  indicate  failure,  the  MACRO-11 

subroutine  should  (on  return)  set  the  carry  bit  to 
indicate  failure  and  clear  it  to  indicate  success. 
Remember,  the  routine  must  be  in  the  blank  program 
section . 

$TST 

$TST  is  used  to  test  if  a  mapping  number  is  in  the 
I FORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TST  succeeds  only  if  the  mapping  number  is  in 
the  I FORM  queue;  for  example,  <$TST  MAP=1>. 

$TSTN0T 

$TSTNOT  is  used  to  test  if  a  mapping  number  is  not  in 
the  I FORM  queue.  A  MAP  attribute  specifies  the  mapping 
number.  $TSTN0T  succeeds  only  if  the  mapping  number  is 
not  in  the  IFORM  queue.  The  syntax  is  identical  to 
$TST . 

$L0AD,name 

$LOAD  is  used  to  load  an  overlay  from  a  parser  or 
translator  table.  The  argument  "name”  specifies  the 

name  of  the  overlay  as  specified  in  the  overlay 
description  file. 

$CALL0V, name 

$CALL0V  is  used  to  load  and  activate  part  of  either  a 
parser  or  translator  table.  The  starting  address 
within  the  overlay  must  be  contained  in  the  first  word 
of  the  overlay.  Use  .WORD  to  specify  the  address.  On 
return,  the  previous  overlay  is  loaded.  The  argument 
"name”  specifies  the  name  of  the  overlay  as  specified 
in  the  overlay  description  file. 

$NULL 

$NULL  is  used  to  execute  attributes  without  specifying 
a  syntax  element.  $NULL  succeeds  if  the  attributes 
succeed . 

$AB 

$AB  (angle  bracket)  is  equivalent  to  the  literal  "<" 
and  is  used  to  pass  the  "<"  as  an  argument  to  MACRO-11. 

$BA 

$BA  is  equivalent  to  the  literal  ">"  and  is  used  to 
pass  the  ">”  as  an  argument  to  MACRO-11. 
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12.11.6  Example  from  DCL  Command  Tables 


♦TITLE  ASSIGN 
♦IDENT  /00/ 

♦PSECT  ♦CHEF 
♦ENABL  LC 

THIS  SOFTWARE  IS  FURNISHED  UNDER  A  LICENSE  AND  MAY 
BE  USED  OR  COPIED  ONLY  IN  ACCORDANCE  WITH  THE  TERMS 
OF  SUCH  LICENSE  ♦ 

COPYRIGHT  (c)  1981  BY  DIGITAL  EQUIPMENT  CORPORATION. 
ALL  RIGHTS  RESERVED ♦ 

AUTHOR:  J.M.  SALMAN 


DATE:  07-0CT-80 

modified:  date  abstract 

function: 

TRANSLATE  THE  DCL  COMMANDS  'ASSIGN' *  ' ASSIGN/QUEUE ' ,  'ASSIGN/REDIRECT', 
'ASSIGN/TASK'  TO  THE  SEMANTICALLY  EQUIVALENT  MCR  COMMANDS  ' ASN ' ,  'QUE', 
'RED',  'REA'. 

THE  FOLLOWING  TABLE  DEFINES  THE  MAPPING  OF  THE  DCL  TO  MCR  SYNTAX: 


DCL  SYNTAX  ELEMENT 

MCR  SYNTAX  ELEMENT 

MAPPING  LETTER/NUMBER 

<Queuen3me> 

<Queuen3ne> 

PI 

Orocessorn3»e> 

<processorn3me> 

P2 

<olddevice> 

<olddevice> 

P3 

<newdevice> 

<newdevice> 

PA 

<t3skri3n»e> 

<t3sknsme> 

P5 

<device> 

<device> 

P6 

<lun> 

<lun> 

P7 

<device> 

<device> 

P8 . 

< logics  1 dev ice> 

<losilC3ldevice> 

P9  ♦ 

9 

/GLOBAL 

/GBL 

PIO. 

/LOGIN 

/LOGIN 

Pll. 

5 

assign: 

/TERMINAL  =  <temdev> 

/TERM=<termdev> 

P12  ♦ 

.PAGE 

♦ 

. 

OR  <QUEUE  BS=B1> 

<REDIR  BS=B2>  <TASK  BS= 

B3>  <LOGDEV  BS=B4> 

END 


QUEUE:  AND  '/  < ' QUEUE , 1 >  <$PRONC  MAP=1  PRO=*QNMSG  ERR=$BQMS6> 

AND.  <$PROC  MAP=2  PRQ=$PRMSG  ERR=$IPMSG> 

END 


REDIR:  AND  '/  < 'REDIRECT , 1>  <$ODEVE  MAP=3  PRO=$FRMSG> 

AND.  <$ODEVE  MAP=4  PRQ=*TOMSG> 

END 


TASK:  AND  '/  < ' T ASK , 2>  $OSEP  <$R50,1,6  MAP  =  5  PRO  =  $TKMSG  ERR  =  $ITMSG> 

AND.  <$ODEVE  MAP=6  PRQ=*DVMSG> 

AND.  <$DNUM ,1,5  MAP=7  PRO=$LUMSG  ERR=$NEMSG> 

END 
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LQGDEVt 

AND 

<$ODEVE  MAP  =  8 .  PRO  =  $DVMSG>  <$ODEVE  i 

END 

gual: 

OR 

< ' GLOBAL  t 1  MAP  =  1 0 ♦  CBM  =  B1!B2> 

OR* 

< ' LOCAL  9 3  CBM=B1> 

OR. 

< ' LOGIN  9 3  MAP=1 1 .  CBM=B1> 

OR* 

<' SYSTEM  > 1  MAP  =  10  »  CBM  =  B1!B2> 

OR. 

END 

.PAGE 

<$TERM  M A P  = 1 2 ♦  CBM  =  B2> 

mcrasn: 

» 

OR 

<GUE  B S T  =  B 1 >  <RED  BST  =  B2>  <REA  BST  =  : 

END 

gue: 

AND 

<< ' GUE  >>  <MAP=2>  '/AS?  <MAP=1> 

END 

red: 

AND 

«'RED  »  <MAP  =  4>  '=  <MAP=3> 

END 

rea: 

AND 

<< ' REA  »  <MAP  =  5>  «'  »  <MAP  =  7>  « 

END 

asn: 

AND 

<<  '  ASN  »  <MAP  =  8  »  >  '  =  <MAP  =  9 . >  <QUA 

END 

laug: 

OR 

<  ' GBL  MAP=10 ♦ > 

OR. 

< ' LOG  IN  MAP  =  1 1 « > 

OR. 

< ' TERM=  AND=VTERM> 

END 

vterm: 

AND 

<MAP=1 2 ♦ > 

END 

.ENABLE 

LC 

iBGMSG! 

ERROR 

</IlleSsl  Queue  navie/> 

$DVMSGJ 

PROMPT 

</Device?  /> 

*frmsg: 

PROMPT 

</From?  /> 

♦ipmsg: 

ERROR 

</Ille23l  processor  n3me/> 

*itmsg: 

ERROR 

C/IlleSsl  task  n3me/> 

$ldmsg j 

PROMPT 

</Lo2ic3l  device?  /> 

$lumsg: 

PROMPT 

</Lo3ic3l  unit?  /> 

♦prmsg: 

PROMPT 

</Processor?  /> 

$qnmsg: 

PROMPT 

</Gueue?  /> 

$tkmsg: 

PROMPT 

< / T 3 s k ?  /> 

*tomsg: 

PROMPT 

</T o?  /> 

♦ DSABLE 
.END 

LC 
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CHAPTER  13 


POOL  MONITORING  SUPPORT 


Pool  monitoring  support  controls  the  use  of  the  system's  dynamic 
storage  region  (pool) .  This  support  monitors  pool  levels,  restricts 
use,  and  notifies  you  when  pool  is  near  depletion.  This  support 
consists  of  two  parts:  the  RSX-11M/M-PLUS  Executive  pool  monitor 

code,  and  the  privileged  Pool  Monitor  Task  ( PMT) . 

Pool  monitoring  support  is  not  available  on  unmapped  systems. 


13.1  HOW  YOU  GET  POOL  MONITORING  SUPPORT 

On  RSX-11M  systems,  you  receive  pool  monitoring  support  when  you 
select  the  pool  monitoring  support  option  in  system  generation 
(SYSGEN) .  If  you  select  the  option,  you  receive  the  Executive  pool 
monitor  code  and  SYSGEN  assembles  and  task-builds  PMT.  If  you  do  not 
select  the  option,  you  do  not  receive  any  pool  monitoring  support. 


On  RSX-1 1M-PLUS  systems,  pool  monitoring  support,  including  the 
Executive  pool  monitor  code  and  PMT,  is  included  by  default.  SYSGEN 
establishes  the  support  for  you.  You  need  not  select  any  option  for 
it . 


One  of  PMT's  features  is  that  it  responds  to  extreme  fragmentation. 
Due  to  the  seriousness  of  this  pool  problem,  PMT  requires  your 
interaction  to  aid  in  system  recovery.  Therefore,  if  you  select  pool 
monitoring  support,  you  must  be  prepared  to  respond  to  PMT's  prompts 
(see  Section  13.3.4). 


13.2  THE  EXECUTIVE  POOL  MONITOR  CODE 


The  pool  monitor  code  within  the  Executive  monitors 
pool  and  detects  major  pool  events.  When  a  major 
the  Executive  notifies  PMT  of  the  event  and  of  the 
of  pool. 


the  amount  of  free 
pool  event  occurs, 
current  condition 


13.2.1  Pool  Events  Affecting  the  Executive 

The  Executive  pool  monitor  code  responds  to  three  major  pool  events. 
These  events  are  classified  as  either  low  or  high  pool  events.  The 
occurrence  of  these  events  directly  affects  the  condition  of  pool, 
creating  either  a  high  or  low  pool  condition.  The  Executive  responds 
by  notifying  PMT  of  the  pool  event  and  the  resultant  pool  condition 
and  also  activates  PMT.  Any  further  response  to  the  pool  condition  is 
left  to  PMT. 
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13.2.1.1  High  Pool  Event  -  The  following  is  the  possible  high  pool 
event : 

•  The  attainment  of  a  high  pool  condition  from  a  low  pool 
condition . 

This  event  occurs  when  a  system  that  has  a  low  pool  condition 
relinquishes  enough  pool  to  cause  the  amount  of  free  pool  to  rise 
above  the  high  limit. 

The  high  pool  limit  is  set  using  the  MCR  and  VMR  SET  PLCTL  command. 
See  Section  13.4  for  further  discussion  of  the  high  limit. 


13.2.1.2  Low  Pool  Event  -  The  following  are  the  possible  low  pool 
events : 


•  The  degradation  of  pool  from  a  high  pool  condition  to  a  low 
pool  condition 

•  A  pool  allocation  failure 

The  degradation  of  pool  occurs  when  the  total  amount  of  free  pool  has 
fallen  below  the  low  limit.  A  pool  allocation  failure  occurs  when  the 
largest  pool  fragment  is  too  small  for  the  process  requesting  it.  A 
pool  allocation  failure  is  not  to  be  confused  with  future  discussions 
in  this  chapter  of  general  pool  fragmentation  and  extreme  pool 
fragmentation.  Pool  allocation  failures  and  pool  fragmentation  are, 
in  the  context  of  this  chapter,  separate  pool  problems  and  are 
discussed  separately.  See  Section  13.3.1  for  additional  information 
on  pool  fragmentation. 

The  low  pool  limit  is  set  using  the  MCR  and  VMR  SET  /PLCTL  command. 
See  Section  13.4  for  further  discussion  of  the  low  limit. 


13.2.1.3  Pool  Monitoring  Interface  -  The  mechanism  used  by  the 
Executive  to  detect  pool  events  is  called  the  pool  monitor  interface. 
The  details  of  how  this  interface  works  are  beyond  the  scope  of  this 
manual.  However,  it  is  fully  described  in  the  source  code  for  the 
Executive  module  CORAL. MAC.  CORAL. MAC  is  in  [11,10]  on  your  kit.  In 
summary,  the  interface: 

•  Provides  the  Executive  with  the  ability  to  declare  information 
to  a  pool  monitor  task. 

•  Provides  the  Executive  with  the  capability  to  receive  a 
response  or  acknowledgement  from  a  pool  monitor  task.  (An 
acknowledgement  can  be  used  by  the  Executive  to  control 
further  information  declarations.) 


13.2.2  Pool  Conditions 

The  condition  of  pool  is  directly  related  to  major  pool  events  and 
also  to  the  acceptable  high  and  low  pool  limits  you  specify.  (You  set 
and  manipulate  these  limits  using  either  the  MCR  or  VMR  SET  /PLCTL 
command  described  in  Section  13.4).  When  a  major  pool  event  occurs 
and  causes  the  size  of  free  pool  to  cross  the  low  or  high  limit,  a  new 
pool  condition  exists.  The  possible  pool  conditions  are  low  pool  and 
high  pool. 
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A  high  pool  condition  exists  when  the  amount  of  free  pool  is 
sufficient  to  support  current  and  less  demanding  system  workloads. 

A  low  pool  condition  exists  when  the  amount  of  free  pool  is  nearing 
the  point  where  system  performance  will  seriously  degrade  if  the 
system's  workload  increases. 

Major  pool  events  cause  either  a  high  or  low  pool  condition  to  exist. 
In  turn,  a  high  or  low  pool  condition,  combined  with  a  specific  pool 
fragmentation  level,  creates  either  a  high  or  low  pool  state.  Pool 
states  are  discussed  in  Section  13.3. 


13.3  THE  POOL  MONITOR  TASK 

The  Pool  Monitor  Task  ( PMT)  is  assembled,  task-built,  and  installed 
during  the  SYSGEN  procedure.  Whenever  the  resultant  system  is  booted, 
PMT  is  activated  by  the  Executive. 

(If  you  do  not  wish  to  use  the  DIGITAL-suppl ied  Pool  Monitor  Task,  you 
do  have  the  option  to  write  and  run  your  own  pool  monitor  task.  If 
you  wish  to  write  your  own  pool  monitor  task,  you  should  first  be 
familiar  with  the  Executive  pool  monitor  interface.  The  interface  is 
documented  in  the  Executive  module  [ 11 , 10] CORAL. MAC.  A  task  installed 
on  a  system  that  supports  pool  monitoring  and  also  has  the  task  name 
"PMT..."  is  considered  to  be  a  "pool  monitor  task".) 

PMT's  first  responsibility  is  to  monitor  pool  conditions.  The 
conditions  that  PMT  responds  to  include  those  detected  and  reported  by 
the  Executive  (see  Section  13.2).  PMT's  second  responsibility  is  to 
monitor  pool  fragmentation.  Through  this  monitoring,  PMT  can  respond 
to  another  major  pool  event  and  also  react  to  extreme  pool 
fragmentation.  The  other  major  pool  event  (not  reported  by  the 
Executive)  occurs  when  PMT  detects  that  the  largest  free  pool  fragment 
is  less  than  the  minimum  required  fragment  size.  (See  Section  13.3.4 
for  further  discussion  of  extreme  fragmentation.) 

Once  it  has  been  activated  by  the  Executive,  PMT  basically  operates  in 
a  cycle.  Whenever  it  receives  the  Executive's  notification  of  a  pool 
condition,  or  at  least  at  regular  time  intervals,  PMT  determines  the 
size  of  the  largest  pool  fragment.  It  then  compares  this  size  to  the 
minimum  required  fragment  size.  Based  on  the  Executive's  report  on 
the  current  pool  condition  and  what  PMT  detects  when  monitoring 
fragmentation,  PMT  determines  what  the  current  state  of  pool  is  and 
responds  to  it  accordingly. 

The  minimum  required  fragment  size  is  set  using  the  MCR  and  VMR  SET 
/PLCTL  command.  See  Section  13.4  for  further  discussion  of  the 
minimum  required  fragment  size. 


13.3.1  Conditions  Affecting  PMT 

PMT  responds  to  pool  fragmentation  and  to  pool  conditions;  however, 
the  response  varies  depending  upon  the  current  level  of  pool 
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fragmentation.  The  two  levels  that  influence  PMT's  response  are  as 
follows : 

•  If  the  largest  fragment  is  equal  to  or  greater  than  the 
minimum  required  fragment  size,  PMT  then  acts  only  on  the 
condition  of  pool  as  reported  by  the  Executive. 

•  If  the  largest  fragment  becomes  smaller  than  the  minimum 
required  fragment  size,  PMT  considers  this  to  be  a  low  pool 
event.  If  the  system  is  not  already  in  a  low  pool  state,  this 
event  causes  a  transition  to  that  state.  PMT  then  responds 
accordingly. 

Although  extreme  fragmentation  is  another  pool  event  that  PMT  responds 
to,  it  is  different  from  those  previously  described.  It  is  defined 
and  documented  in  Section  13.3.4. 

PMT  uses  the  information  it  has  concerning  the  current  level  of 
fragmentation  and  also  the  information  provided  by  the  Executive  to 
determine  the  overall  state  of  pool.  Following  is  a  discussion  of 
PMT's  response  to  specific  pool  events  and  conditions. 


13.3.1.1  Pool  Level  and  Fragment  Size  Are  Satisfactory  -  The 
Executive  notifies  PMT  that  the  pool  level  is  above  the  high  limit  and 
PMT  detects  that  fragment  size  is  greater  than  the  minimum  required 
fragment  size. 

PMT  concludes  that  a  high  pool  state  exists  and  executes  actions 
appropriate  for  a  high  pool  state  (see  Section  13.3.2). 


13.3.1.2  Low  Pool  Condition  -  The  Executive  notifies  PMT  that  a  low 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary.  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  enough  free  pool  has  accumulated  to  push 
the  total  above  the  high  limit.  if  the  change  is  temporary,  PMT 
ignores  the  notification  and  continues  to  execute  high  pool  state 
actions.  if  the  change  is  not  temporary,  PMT  concludes  that  a  low 
pool  state  exists  and  executes  actions  appropriate  for  a  low  pool 
state  (see  Section  13.3.3). 


13.3.1.3  High  Pool  Condition  -  The  Executive  notifies  PMT  that  a  high 
pool  condition  is  achieved. 

PMT  determines  whether  the  change  in  pool  reported  by  the  Executive  is 
temporary. .  The  change  is  temporary  if,  by  the  time  PMT  responds  to 
the  Executive's  notification,  the  total  amount  of  free  pool  has  moved 
below  the  high  limit.  if  the  change  is  temporary,  PMT  ignores  the 
notification  and  continues  to  execute  low  pool  state  actions.  if  the 
change  is  not  temporary,  PMT  initiates  actions  appropriate  for  a  high 
pool  state  (see  Section  13.3.2). 


13.3.1.4  Largest  Pool  Fragment  Is  Too  Small  -  PMT  detects  that  the 

largest  pool  fragment  is  smaller  than  the  minimum  required  fragment 
s  i  ze  • 
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PMT  concludes  that  a  low  pool  state  exists  and  executes  actions  for  a 
low  pool  state.  Note  that  this  low  pool  state  overrides  any  pool 
conditions  reported  by  the  Executive.  This  pool  event  will  cause  the 
system  to  be  in  a  low  pool  state  even  if  the  Executive  reports  a  high 
pool  condition. 


13.3.1.5  Largest  Pool  Fragment  Becomes  Larger  -  PMT  detects  that  the 
size  of  the  largest  pool  fragment  has  become  larger  than  the  minimum 
required  fragment  size. 

PMT  decides  that  the  current  pool  state  must  be  based  upon  the  latest 
pool  condition  reported  by  the  Executive.  If  the  Executive  reported  a 
high  pool  condition,  PMT  decides  that  a  high  pool  state  exists.  If 
the  Executive  reported  a  low  pool  condition,  PMT  decides  that  a  low 
pool  state  exists.  In  either  situation,  PMT  takes  the  appropriate 
action  for  that  state. 


13.3.2  PMT  Default  Actions  for  a  High  Pool  State 

When  PMT  concludes  that  a  high  pool  state  exists,  it  executes  the 
following  actions : 

•  Sets  its  internal  cycle  interval  to  one  minute 

•  Enables  checkpointing  for  itself 

•  Removes  any  pool  use  controls 

PMT  then  stops  itself  so  that  its  impact  on  system  resources  is 
minimized.  PMT  unstops  itself  when  the  internal  cycle  interval  has 
elapsed . 


13.3.3  PMT  Default  Actions  for  a  Low  Pool  State 

When  PMT  concludes  that  a  low  pool  state  exists,  it  executes  the 
following  actions : 

•  Disables  checkpointing  for  itself. 

•  Sets  its  internal  cycle  interval  to  20  seconds. 

•  Establishes  pool  use  controls  as  follows: 

a.  Prevents  nonpr ivileged  users  from  logging  on. 

b.  Suppresses  INSTALL/RUN/REMOVE  sequences  on  nonpr iv il eg ed 
terminals. 

c.  Delays  nonpr iv il eg ed  task  loading. 

NOTE 

Nonpr ivileged  tasks  with  a  task  priority  less  than 
the  specified  base  priority  cannot  compete  for 
memory  resources  until  a  high  pool  state  exists 
(see  Section  13.4.3).  This  does  not  mean  that 
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such  tasks  cannot  be  requested;  they  will  simply 
remain  blocked  from  execution  until  PMT  concludes 
that  a  high  pool  state  exists.  All  other  tasks, 
including  any  tasks  already  active  at  the  onset  of 
the  low  pool  state,  are  not  affected  by  this 
control . 


Sends  a  warning  message  to  all  logged  on  terminals  (or 
on-line  terminals  on  systems  without 
multiuser-protection).  This  message  cannot  be  suppressed 
by  the  MCR  SET  /NOBRO  command  or  the  DCL  SET  TERM 
/NOBROADCAST  command. 


Sends  a  warning  message  to  and  displays  pool  statistics  at 
the  console  terminal. 


13.3.3.1  PMT  Output  to  Terminals  During  Low  Pool  State  -  When  PMT 

determines  that  a  low  pool  state  exists,  PMT  sends  the  following 
warning  message  to  logged  on  terminals  (or  on-line  terminals  on 
systems  without  multiuser  protection) : 

08-AUG-81  13:35:10  —  Low  pool  —  Please  exit  active  tasks  -  ZEPHYR 

The  effect iveness  of  this  message  depends  on  whether  users  exit  from 
their  active  tasks.  If  they  choose  to  ignore  this  message,  a  low  pool 
state  continues  to  exist. 

ZEPHYR  is  the  system  name  selected  during  SYSGEN  or  the  DECnet  node 
name  (if  DECnet  is  running  on  your  system). 

PMT  sends  this  message  at  20-second  intervals  until  it  concludes  that 
a  high  pool  state  exists. 


13.3.3.2  PMT  Output  to  the  Console  Terminal  During  Low  Pool  State  - 
In  a  low  pool  state,  PMT  also  sends  a  warning  message  to  and  displays 
pool  statistics  at  the  console  terminal.  The  following  is  an 
annotated  example  of  PMT  output  to  the  console  terminal: 


08-AUG-81  13:35:10  —  Warning  —  Pool  is  critically  low 
Total  free  pool  =  1116.  bytes  © 

Largest  fragment  =  112.  bytes  0 


o 


In  this  example,  PMT: 


©  Sends  a  warning  message 

©  Displays  the  amount  of  free  pool  existing  at  the  onset  of 
the  low  pool  state 

©  Displays  the  size  of  the  largest  free  fragment  of  pool 
existing  at  the  onset  of  the  low  pool  state 


PMT  broadcasts  this  message  at  20-second  time  intervals  until 
concludes  that  a  high  pool  state  exists. 


it 
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13.3.4  PMT  Default  Actions  for  Extreme  Fragmentation 

Extreme  fragmentation  exists  when  the  largest  pool  fragment  is  less 
than  84(10)  bytes.  In  this  case,  pool  is  exhausted  and  it  is  not 
possible  to  free  any  pool  by  unsolicited  terminal  input,  for  example, 
issuing  an  ABORT  command.  At  this  point,  PMT  takes  immediate  action 
to  prevent  total  pool  depletion  by  executing  the  following  steps: 

•  Enters  kernel  mode,  which  prevents  any  other  tasks  from 
executing  but  does  allow  the  system  to  respond  to  device 
interrupts . 

•  Prevents  the  invocation  of  TKTN •  (Invoking  TKTN  at  this  time 
depletes  the  available  pool.)  It  does  this  by  clearing  TKTN 1 s 
special  TCB  pointer  that  is  stored  within  the  Executive. 

•  Sends  a  warning  message  to  the  console  terminal. 

•  Prompts  you  to  abort  one  or  more  of  the  tasks  displayed.  (You 
must  be  at  the  console  to  free  pool  in  response  to  the  PMT 
prompts.)  After  you  select  a  task  to  abort,  PMT  returns  to 
user  mode  until  the  abort  operation  is  finished. 

•  Displays  a  message  at  the  terminal  running  the  task  and  the 
console  terminal  if  the  task  is  successfully  aborted. 

•  Displays  (upon  request)  an  updated  list  of  abortable  tasks  at 
the  console  terminal. 


(On  RSX-11M  systems  84(10)  bytes  is  the  size  of  a  CLI  command  buffer.) 


13.3.4.1  Abortable  Tasks  -  The  abortable  task  list  includes  only 
those  tasks  that  PMT  considers  eligible  to  abort.  A  task  is  abortable 
if  it  meets  the  following  requirements: 

•  It  must  be  active. 

•  It  must  be  resident  in  memory. 

•  It  cannot  be  privileged  and  running  from  the  console  terminal. 

•  It  cannot  be  a  Command  Line  Interpreter  (CLI)  task. 

•  It  cannot  be  an  Ancillary  Control  Processor  (ACP)  task. 

•  It  cannot  be  the  task  loader. 

•  It  cannot  have  any  internal  conditions  that  prevent  it  from 
exiting  upon  an  abort  request  (for  example,  it  is  already 
aborted) . 

The  ability  to  abort  tasks  included  in  this  list  is  a  powerful  feature 
and  one  that  is  potentially  harmful  to  your  system.  You  should  abort 
tasks  that  consume  pool  and  are  relatively  expendable.  This  action 
should  release  pool  resources  for  use  by  the  remaining  active  tasks 
and  allow  the  system  to  continue  operation,  rather  than  deadlock  over 
pool  resources. 


13-7 


THE  SHUFFLER 


On  RSX-11M-PLUS ,  tasks,  device  drivers,  dynamic  common  regions,  and 
static  common  regions  reside  in  subpartitions  of  the  system-controlled 
partition.  Static  common  regions  are  resident  libraries  and  resident 
commons  and  both  may  be  shared  by  tasks  for  more  efficient  use  of 


physical  memory.  Resident 

commons  contain  data. 

libraries  contain 

code , 

and 

resident 

On  RSX-1 1M ,  static  common 

regions  must  be 

loaded 

into 

common 

partitions.  A  common  partition  is  a  dedicated  area  of  memory  that  may 
be  shared  by  tasks.  Tasks,  device  drivers,  and  dynamic  common  regions 
created  by  memory  management  directives  must  be  loaded  into 
subpartitions  of  the  system-controlled  partition. 


14.1.1  System-Controlled  Partitions 

Only  mapped  systems  support  system-controlled  partitions.  A  mapped 
system  is  a  system  with  memory  management.  A  task  in  a  mapped  system 
can  run  in  any  system-controlled  partition  large  enough  to  contain  it, 
and  the  Executive  is  responsible  for  allocating  space  in  that 
partition.  Refer  to  the  RSX-11M/M-PLUS  MCR  Operations  Reference 
Manual  for  detailed  information  on  system-controlled  partitions  and 
memory  management. 

The  Executive  allocates  dynamic  memory  space  for  waiting  tasks  in  the 
following  manner: 

1.  Uses  a  priority  level  of  1  through  250  to  determine  a  waiting 
task's  use  of  a  system-controlled  partition.  A  higher  number 
indicates  a  higher  priority. 

2.  Begins  at  the  base  of  the  partition  and  searches  for  a  free, 
contiguous  area  large  enough  for  the  waiting  task. 

3.  Creates  a  dynamic  subpartition  within  the  system-controlled 
partition . 

4.  Eliminates  the  subpartition  to  free  memory  when  the  task  has 
finished  execution . 

In  some  instances,  a  waiting  task  cannot  be  loaded  into  a 
system-controlled  partition  because  there  is  not  enough  memory  space 
available.  If  there  is  not  enough  space  to  load  a  waiting  task,  the 
Executive  uses  checkpointing  to  make  memory  space  available  to  the 
waiting  task. 

To  make  room  for  a  waiting  task,  the  Executive  searches  the 
system-controlled  partitions  for  one  or  more  tasks  with  a  lower 
priority  than  that  of  the  waiting  task.  The  Executive  then 
checkpoints  (moves)  the  task  of  lower  priority  from  memory  to  disk  to 
make  room  for  the  waiting  task  of  higher  priority.  The  checkpointed 
task  is  immediately  placed  in  competition  with  other  tasks  waiting  for 
residency.  When  the  checkpointed  task  is  reloaded,  it  continues 
processing  from  the  point  where  it  was  interrupted. 

On  RSX-1 1M-PLUS ,  the  Executive  keeps  track  of  outstanding  I/O  on  a 
partition-by-partition  basis.  Thus,  the  Executive  may  checkpoint 
subpartitions  with  dynamic  common  regions,  static  common  regions,  and 
task  regions  if  there  is  no  I/O  pending. 
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On  RSX-11M,  the  Executive  keeps  track  of  outstanding  I/O  on  a 
task-by-task  basis.  The  Executive  cannot  easily  determine  to  which 
partition  outstanding  I/O  is  directed.  Therefore,  RSX-11M  can  only 
checkpoint  subpartitions  with  task  regions.  Common  partitions  and 
dynamic  common  regions  created  by  memory  management  directives  cannot 
be  checkpointed. 


14.1.2  Partition  Fragmentation 

Checkpointing  does  not  always  create  enough  memory  space  to  load  a 
waiting  task.  This  is  a  result  of  partition  fragmentation. 
Fragmentation  in  system-controlled  partitions  occurs  when  tasks  of 
various  sizes  are  entering  and  exiting  memory,  or  when,  for  example, 
device  drivers  are  loaded  in  the  middle  of  a  system-controlled 
partition.  Device  drivers,  which  cannot  be  checkpointed,  often  create 
space  between  subpartitions  and  below  subpartitions  called  fragments. 

Tasks  with  nonbuffered,  outstanding  I/O  cause  fragmentation  of 
system-controlled  partitions.  Such  tasks  cannot  be  checkpointed.  The 
Executive  must  wait  for  the  task's  I/O  count  to  reach  zero  before  the 
task  can  be  checkpointed.  While  the  Executive  waits  for  the  task's 
I/O  count  to  reach  zero,  the  task  is  blocked  from  execution  to  prevent 
the  task  from  issuing  more  I/O  requests  that  could  delay  the  loading 
of  the  waiting  task.  The  following  lists  the  serious  causes  of 
fragmentation  in  system-controlled  partitions: 


1.  Device  drivers  loaded  in  the  middle  of  a  system-controlled 
partition 

2.  Subpartitions  that  are  connected  to  the  IP11  driver 

3.  Subpartitions  that  are  connected  to  an  interrupt  vector  by 
means  of  a  CINT$  directive 

4.  Subpartitions  with  nonbuffered,  long-outstanding  I/O,  and 
whose  I/O  count  has  not  yet  dropped  to  zero 

5.  Regions  that  have  been  fixed  by  the  Executive  for  a  memory 
parity  error 

6.  Dynamic  regions  created  by  PLAS  directives  (RSX-11M  only) 

If,  for  any  reason,  including  fragmentation,  the  Executive  is  unable 
to  load  a  waiting  task  into  a  subpartition,  the  Executive  requests  the 
Shuffler.  The  Shuffler  moves  subpartitions  in  system-controlled 
partitions  in  an  attempt  to  create  the  free  space  necessary  to  load  a 
waiting  task.  Thus,  the  Executive  requests  the  Shuffler  only  when  all 
other  attempts  to  load  a  waiting  task  fail. 


14.2  SHUFFLER  PERFORMANCE 

The  Shuffler  is  approximately  700(10)  words  and  can  be  installed  only 
on  a  mapped  system.  The  Shuffler  is  installed  during  system 
generation  by  a  VMR  command  and  by  default  is  built  for  the  partition 
SYSPAR,  which  can  also  be  used  by  the  MCR  dispatcher  and  TKTN .  Refer 
to  the  RSX-11M  or  RSX-11M-PLUS  System  Generation  and  Installation 
Guide  for  more  information  on  installing  the  Shuffler. 
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The  overhead  incurred  for  the  Shuffler  task  is  found  in  the  Shuffler, 
not  in  the  Executive.  The  Shuffler  responds  well  on  a  system  if  there 
are  fewer  tasks  loaded  in  memory  and  if  the  Shuffler  does  not  execute 
frequently.  If  you  have  a  heavily  loaded  system,  the  Shuffler  may 
execute  more  than  you  want  because  of  repeated  memory  allocation 
failures.  If  the  Shuffler  executes  frequently  on  your  system,  better 
performance  is  obtained  when  the  Shuffler  is  fixed  in  its  own 
partition  where  it  does  not  have  to  compete  with  MCR  and  TKTN  for 
memory. 

The  word,  $SHFTM,  in  the  Executive's  system  common  area  limits  the 
number  of  times  the  Shuffler  may  be  requested  within  a  time  interval. 
$SHFTM  heightens  the  Shuffler's  effectiveness  on  your  system.  Each 
time  the  Executive  requests  the  Shuffler,  this  timer  is  checked.  If 
the  timer  registers  zero,  the  Shuffler  may  be  requested.  If  the  timer 
registers  a  positive  number,  the  request  for  the  Shuffler  is  ignored. 
The  amount  of  time  (clock  ticks)  that  must  elapse  before  the  Shuffler 
is  requested  again  is  stored  in  the  system  common  area,  $SHFCT.  When 
the  Shuffler  is  successfully  requested,  $SHFTM  is  initialized  for  the 
new  interval  with  the  value  stored  in  $SHFCT. 

If  you  are  a  privileged  user,  you  may  change  $SHFCT.  To  change 
$SHFCT,  you  need  a  copy  of  RSX11.MAP,  the  Executive  map  produced 
during  system  generation.  Using  the  map,  you  must  determine  the 
address  of  the  global  symbol  $SHFCT.  You  can  change  the  contents  of 
the  system  $SHFCT  with  the  MCR  OPEN  command.  The  Shuffler  is 
requested  infrequently  if  the  value  is  set  too  high.  If  the  value  is 
set  too  low  (zero),  system  response  may  decrease  because  the  Shuffler 
is  being  requested  too  frequently. 


14.2.1  Monitoring  The  Shuffler 

Several  memory  allocation  failures  during  peak  usage  periods  result  in 
the  repeated  request  of  the  Shuffler.  The  repeated  execution  of  the 
Shuffler  can  produce  a  noticeable  decrease  in  response  time.  You  may 
monitor  the  Shuffler's  effect  on  your  system  by  using  RMD.  RMD  is  a 
privileged  task  that  displays  information  concerning  task  activity  on 
the  operating  system.  Refer  to  Chapter  6  for  a  detailed  explanation 
of  RMD. 

If  you  want  to  monitor  Shuffler  activity  with  RMD,  you  must  dedicate  a 
video  terminal  on  which  to  run  the  RMD  display.  The  key  features  to 
monitor  on  the  memory  display  page  are  as  follows: 

1.  The  currently  executing  task;  *IDLE*  indicates  that  no  task 
is  executing 

2.  The  number  of  active  tasks  in  memory  and  the  amount  of  memory 
v  they  occupy,  plus  the  number  of  active  tasks  checkpointed  (on 

disk)  and  the  total  memory  they  would  require. 

These  features  show  task  activity.  If  the  Shuffler  is  active,  tasks 
are  moving  down  in  the  partition,  and  the  currently  executing  task 
field  registers  the  Shuffler  as  the  active  task. 

Occasionally,  the  Shuffler  registers  as  the  active  task,  but  tasks 
cannot  be  seen  moving  down  in  the  partition.  To  verify  that  tasks  are 
not  moving  when  the  Shuffler  is  executing,  check  the  number  of  active 
tasks  checkpointed  (on  disk)  and  the  number  of  tasks  waiting  for 
memory.  If  this  count  remains  the  same  over  a  period  of  time,  the 
Shuffler  is  executing  but  cannot  create  enough  space  for  waiting 
tasks.  Thus,  the  Shuffler  is  using  too  much  of  the  system's 
resources.  If  the  system  does  not  recover,  it  might  be  better  to 
abort  the  Shuffler  from  your  system. 
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If  the  Shuffler  task  continues  to  use  too  much  of  the  system's 
resources,  you  should  remove  the  Shuffler  from  your  system  with  the 
MCR  REMOVE  command. 


14.3  THE  SHUFFLER  ALGORITHMS 

When  a  memory  allocation  failure  occurs,  the  Executive  requests  the 
Shuffler.  The  Shuffler  searches  memory  for  a  system-controlled 
partition  that  has  at  least  one  task  waiting  for  space.  When  the 
Shuffler  locates  such  a  system-controlled  partition,  it  attempts  to 
move  (shuffle)  subpartitions  in  the  memory  partition  to  create  the 
continuous  area  necessary  to  load  waiting  tasks. 

On  RSX-11M ,  the  Shuffler  can  only  shuffle  task  subpartitions.  Because 
RSX-11M  does  not  maintain  an  outstanding  I/O  count  on  a 
partition-by-partition  basis,  the  Shuffler  cannot  determine  whether 
outstanding  I/O  is  pending  to  a  common  partition  or  a  dynamic  common 
region.  Thus,  the  Shuffler  does  not  shuffle  common  partitions  or 
subpartitions  with  dynamic  common  regions  created  by  memory  management 
directives. 

On  RSX-11M-PLUS ,  the  Shuffler  does  shuffle  common  regions  because  an 
outstanding  I/O  count  is  maintained  on  a  partition-by-partition  basis. 
Thus  subpartitions  containing  static  common  regions  or  dynamic  common 
regions  can  be  shuffled  when  there  is  no  I/O  pending. 

The  Shuffler  uses  two  algorithms  to  move  subpartitions  in  memory. 
Each  algorithm  executes  several  steps  repeatedly  until  the  partition 
reaches  a  stable  state. 


14.3.1  The  First  Pass  Algorithm 


In  the  first  pass,  the  Shuffler  attempts  to  move  each  subpartition  to 
the  base  of  the  partition.  When  subpartitions  are  moved  to  the  base 
of  the  partition,  free  space  is  created  at  the  top  of  the  partition  so 
that  a  waiting  task  can  enter  memory  if  there  is  enough  space. 
Shuffling  occurs  in  the  following  steps: 


1.  The  Shuffler  requests  the  Executive  to  unconditionally 

checkpoint  all  stopped  checkpointable  subpartitions  and 

checkpointable  subpartitions  that  have  been  blocked  with  a 
CLI  command. 

2.  The  Shuffler  attempts  to  move  each  subpartition  to  the  base 

of  the  partition  and  blocks  each  executable  task  from  further 
execution.  If  a  subpartition  has  outstanding  I/O,  the 
Shuffler  waits  for  the  task's  nonbuffered,  outstanding  I/O 
count  to  reach  zero.  If  the  I/O  count  does  not  reach  zero  in 
approximately  .5  seconds,  the  Shuffler  marks  the  subpartition 
as  having  outstanding  I/O,  and  restarts  the  first  pass 

algorithm.  The  Executive  clears  the  subpartition's  I/O 

indicator  when  the  task's  I/O  count  becomes  zero. 

3.  The  Shuffler  moves  each  task  to  the  base  of  the  partition. 

If  the  subpartition's  I/O  count  reaches  zero  within  30 

seconds . 


4. 


Each  subpartition  is  unblocked  to  allow  further 
after  shuffling  is  complete,  and  the  free  space, 
the  subpartition,  is  deallocated. 


execution 
now  above 
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Be  aware  that  a  fixed  task  can  be  shuffled.  If  you  do  not  want  to 
have  a  fixed  task  shuffled,  you  must  fix  this  task  in  a 
user-controlled  partition  or  in  its  own  dedicated  system-controlled 
partition. 

If  fragmentation  has  not  occurred  at  the  end  of  the  first  pass,  the 
Shuffler,  has  successfully  merged  the  free  space  in  the  partition  into 
one  continuous  area  at  the  top  of  the  system-controlled  partition.  A 
task  may  be  loaded  into  memory  if  there  is  enough  available  space. 

Memory  space  may  not  be  available  if  there  are  several  tasks  already 
loaded  in  memory,  or  if  fragmentation  is  dividing  the 
system-controlled  partition  into  two  or  more  partition  sections. 

A  partition  section  is  a  subset  of  the  area  in  a  system-controlled 
partition.  Each  partition  section  is  flanked  on  at  least  one  side  by 
a  subpartition  that  cannot  be  shuffled.  For  example,  if  a  device 
driver  is  loaded  in  the  middle  of  a  system-controlled  partition,  the 
system-controlled  partition  is  divided  into  two  partition  sections 
because  a  device  driver  is  a  subpartition  that  cannot  be  moved. 

If  during  the  first  pass  algorithm,  the  Shuffler  encounters  a 
subpartition  that  cannot  be  moved,  the  Shuffler  begins  to  shuffle 
subpartitions  that  can  be  moved  to  the  base  of  the  partition  section 
that  bounds  it.  The  Shuffler  cannot  shuffle  subpartitions  around  a 
subpartition  that  cannot  be  moved.  Therefore,  if  fragmentation  has 
occurred  during  the  first  pass,  the  system-controlled  partition  is 
divided  into  two  or  more  partition  sections,  and  the  free  space  in  the 
partition  may  no  longer  be  merged  at  the  top  of  the  partition,  but 
rather  at  the  top  of  the  partition  section. 

The  Shuffler  initializes  the  second  pass  algorithm  if  enough  memory 
space  is  not  available  for  waiting  tasks,  or  if  fragmentation  has 
lvided  the  system-controlled  partition  into  several  partition 
Little  memory  space  or  partition  sections  prevent  the 
Shuffler  from  accumulating  all  the  free  space  at  the  top  of  the 
partition.  The  free  space  in  each  partition  section  is  separate  and 
cannot  be  merged  with  the  free  space  in  another  partition  section. 


14.3.2  Second  Pass  Algorithm 

?econd  pass  algorithm  is  executed  once  for  each  partition  section 
within  a  system-controlled  partition.  This  pass  attempts  to  create  a 
reverse  priority  list  of  subpartitions  that  can  be  checkpointed  by  the 
waiting  task.  During  the  second  pass,  the  Shuffler  creates  a  list  in 
ascending  priority  order  of  the  subpartitions  in  each  partition 
section.  The  Shuffler  then  compares  the  size  of  the  waiting  task  with 
the  sum  of  free  space  in  the  partition  section  plus  the  total  of  one 
or  more  lower  priority,  checkpointable  tasks.  If  the  waiting  task  is 

priority  task C ler  requests  the  Executive  to  checkpoint  the  lower 


Checkpointing  the  lower  priority  task(s)  may  create  new  space,  but  the 
new  space  may  not  comprise  a  continuous  area  in  memory.  The  Executive 
may  begin  the  first  pass  alogorithm  to  accumulate  the  free  space  of 
the  partition  section.  The  free  space  is  then  allocated  to  the 
waiting  task.  As  long  as  there  are  subpartitions  that  cannot  be  moved 
m  a  system-controlled  partition,  memory  is  still  divided  into  two  or 
more  partition  sections. 
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If  the  Shuffler  completes  the  second  pass  without  finding  room  for  a 
waiting  task,  the  Shuffler  searches  for  the  next  system-controlled 
partition  with  waiting  tasks.  If  there  are  no  other  system-controlled 
partitions  with  tasks  waiting  for  memory  space,  the  Shuffler  exits. 
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RSX-1 1M-PLUS  SYSTEM  RECONFIGURATION 


A  reconf igurable  system  is  a  system  in  which  you  can  add  or  remove 
system  resources  such  as  memory  and  devices.  Reconfiguration  is  a 
means  of  physically  and  logically  connecting  and  disconnecting  various 
resources.  This  chapter  discusses  the  purpose  and  application  of 
reconfiguration,  and  describes  the  components  and  commands  of  the 
reconfiguration  services. 

System  reconfiguration  is  available  only  on  RSX-11M-PLUS  systems. 
Some  of  the  information  in  this  chapter,  however,  applies  only  to 
multiprocessor  systems.  Blue  ink  is  used  to  distinguish  this 
information . 


15.1  THE  RECONFIGURATION  SERVICES 

The  reconfiguration  services  allow  you  to  reconfigure  an  RSX-11M-PLUS 
system  to  bypass  faulty  hardware  elements  and  to  isolate  the  system 
from  the  effects  of  these  elements. 

With  the  reconfiguration  services,  you  can  define  a  set  of  hardware 
resources  that  are  accessible  from  the  on-line  system  and. also  remove 
devices  from  the  pool  of  resources  allocated  to  the  on-line  system. 
For  example,  after  booting  the  system,  you  can  place  a  failed  disk 
drive  off  line  and  then  use  another  drive  that  is  already  on  line  or 
place  one  on  line  to  take  over  for  the  disabled  unit. 


15.1.1  Reconfiguration  Components  (CON ,RD: ,HRC) 1 

You  reconfigure  system  resources  by  using  together  a  command  interface 
(CON),  a  loadable  driver  (RD:),  and  a  privileged  reconfiguration  task 
(HRC) .  HRC  and  CON  must  have  enough  checkpoint  space  allocated  for 
them  both  to  be  resident  in  memory  at  the  same  time.  If  the  operating 
system  cannot  load  both  tasks  at  the  same  time,  CON  commands  will 
fail. 

CON,  as  the  command  interface,  receives  and  parses  the  commands  that 
you  issue  to  reconfigure  the  current  system.  CON  then  creates  and 
submits  QIO  packets  to  the  reconfiguration  driver  (RD:). 


1.  DIGITAL  will  accept  SPRs  regarding  the  interface  but  reserves  the 
right  to  treat  such  SPRs  as  informational  only. 
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RD: ,  the  reconfiguration  driver,  serves  as  an  interface  between  a  user 
task  (either  CON  or  a  user  application  task)  and  the  HRC  task;  it  is 
the  gateway  between  tasks  that  generate  reconfiguration  requests  and 
the  actual  implementation  of  those  requests.  RD:  accepts  QIO  packets 
from  any  task  and  places  these  packets  into  the  receive  queue  of  HRC.l 
Before  passing  the  QIO  packets  to  HRC ,  RD:  performs  privilege  and 
address  boundary  checks  on  them.  The  checks  ensure  that  the  packets 
are  using  valid  addresses  and  legal  function  codes,  and,  for  some 
functions,  that  RD:  is  attached  to  them. 

HRC,  the  privileged  reconfiguration  task,  performs  the  actual 
reconfiguration  operations  for  the  system.  To  process  reconfiguration 
requests,  HRC  calls  Executive  routines,  which  then  call  the  associated 
device  drivers.  HRC  services  the  requests  for  configuration 
information  by  passing  the  desired  information  directly  to  the  user 
buffer . 

After  HRC  services  the  request,  a  status  is  returned  (by  means  of  I/O 
completion)  to  the  requesting  task.  The  status  return  was  implemented 
in  part  to  allow  tasks  other  than  CON  to  interface  with  HRC. 

The  data  base  for  each  system  device  contains  status  words  that 
reflect  device  state.  When  you  change  a  system  device  state,  HRC 
modifies  the  appropriate  data  base  status  word  to  either  grant  or 
inhibit  device  access. 


15.1.2  Device  States 

The  RSX-1 1M -PL US  system  reconfiguration  services  control  the 
configuration  state  (on  line  or  off  line)  of  the  hardware  devices,  and 
therefore  control  device  access.  A  system  device  can  assume  one  of 
four  states: 

•  On  line  -  device  on  line,  access  granted 

•  Off  line  -  device  off  line,  access  denied 

•  Marked  for  on  line  -  device  will  be  brought  on  line  when 
access  path  exists,  access  denied 

•  Marked  for  off  line  -  indeterminate  state,  access  denied 

In  the  on-line  state,  a  device  is  logically  on  line  for  access.  This 
state  indicates  that  an  access  path  exists  between  the  device  and  an 
on-line  processor  and  that  a  call  (if  any)  to  the  driver's  controller 
or  unit  status  change  entry  points  was  successful.  RSX-11M-PLUS 
grants  access  to  on-line  devices  only.  To  access  an  on-line  disk  or 
tape  volume  and  perform  virtual  I/O  on  it  (for  example,  reads  or 


1.  Note  that  programs  written  to  use  the  current  version  of  RD:  may 
have  to  be  modified  in  the  next  release.  You  should  centralize  all 
code  concerning  RD:  so  that  modifications  can  be  made  easily. 

Because  of  the  likely  changes,  RD:  has  not  been  documented.  For  some 
information,  check  the  reconfiguration  sources  located  in  UFD  [27,10] 
of  the  distribution  kit  (except  the  RL02  kit,  which  does  not  contain 
any  sources) .  Important  modules  for  the  interface  are  CNHRC ,  HROOT, 
and  HRSUB .  (See  also  the  macro  OLRDF$  in  [1,1] EXEMC . MLB  for  a 
description  of  volume  access  rights  and  mounted  volumes.) 
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writes  to  files) ,  the  volume  must  be  mounted.  (See  the  RSX-11M/M-PLUS 
MCR  Operations  Manual  or  the  RSX-11M/M-PLUS  Command  Language  Manual 
for  a  description  of  volume  access  rights  and  mounted  volumes.) 

When  a  device  is  in  the  off-line  statef  the  system  denies  access  to 
the  device.  Attempts  to  access  an  off-line  device  result  in  an  I/O 
error  (IE.OFL) .  (See  the  IAS/RSX-11  I/O  Operations  Reference  Manual 
for  lists  and  explanations  of  error  codes.)  Taking  a  controller  off 
line  also  takes  all  of  its  associated  units  off  line,  which  places  the 
units  in  the  marked  for  on-line  state. 

The  marked  for  on-line  state  indicates  that  a  request  to  bring  a 
device  or  controller  on  line  has  been  made,  but  part  of  the  access 
path  to  the  device  or  controller  is  off  line.  Access  attempts  yield 
the  error  code  IE.OFL.  HRC  places  a  device  marked  for  on  line 
logically  on  line  when  it  brings  the  entire  access  path  on  line. 

The  marked  for  off-line  state  indicates  that  the  system  encountered  an 
unexpected  error  in  attempting  to  place  a  specific  device  logically  on 
line.  You  must  issue  an  explicit  off-line  command  before  attempting 
or  retrying  an  on-line  operation. 


15.1.3  Placing  Devices  Logically  On  Line  and  Off  Line 

To  place  a  device  logically  on  line,  HRC  first  verifies  that  the 
device  driver  is  loaded  (for  loadable  drivers  only)  and  then  tests 
whether  the  controller  can  access  the  device  (the  controller  must  be 
on  line) .  If  the  controller  can  access  the  device  (an  access  path 
exists) ,  HRC  modifies  the  appropriate  status  word  to  reflect  that  the 
device  is  on  line.  If  the  controller  or  device  cannot  be  accessed, 
HRC  marks  the  device  for  on  line  and  then  places  the  device  on  line 
when  the  access  path  is  brought  on  line. 

Before  placing  a  device  off  line,  HRC  attempts  to  protect  against 
inadvertent  loss  or  possible  corruption  of  data  by  verifying  that  the 
state  change  will  not  interfere  with  active  I/O.  HRC  considers  a 
device  active  and  rejects  off-line  commands  if  the  device  has  context. 
The  reconfiguration  services  define  device  context  as  a  condition  that 
indicates  (or  permits)  I/O  activity  on  the  device.  The  following  is  a 
list  of  conditions  that  define  device  context: 

1.  A  task  is  attached  to  the  device  (for  example,  the  print 
despooler  attaches  the  line  printer) . 

2.  The  device  (or  an  associated  device)  is  a  logged-in  terminal. 

3.  The  device  (or  an  associated  device)  contains  a  mounted 
volume . 

4.  For  the  DT07  bus  switch,  a  port  is  logically  connected  to  a 
processor  (linked) . 

5.  For  memory  boxes,  the  memory  within  the  box  is  logically  on 
line  (multiprocessor  systems  only) . 

You  cannot  take  a  controller  off  line  if  any  of  the  units  on  the 
controller  have  context. 

For  dual-port  disks  (RK06/07,  RM02/03/05/80/RP07 ,  and  RP04/05/06) , 

which  have  each  port  connected  to  a  different  controller,  you  can 
place  off  line  one  path  with  context  as  long  as  the  alternate  path  is 
on  line.  (See  the  description  of  the  OFFLINE  command  for  more 
information. ) 
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15.2  INITIATING  THE  RECONFIGURATION  SERVICES 

You  reconfigure  an  RSX-11M-PLUS  system  interactively  from  a  terminal 
or  by  means  of  indirect  command  files.  The  reconfiguration  services 
act  as  an  interface  between  your  terminal  and  the  RSX-11M-PLUS  system. 

To  issue  a  reconfiguration  command,  type  a  command  line  in  response  to 
the  default  prompt  (>)  or  to  the  explicit  command  interface  prompt 
(CON> ) .  A  command  line  consists  of  three  components:  a  command  name, 
any  required  parameters,  and  a  line  terminator.  (Note  that  there  is 
no  DCL  command  to  access  CON.) 


15.2.1  Invoking  CON 

It  is  not  necessary  to  use  the  entire  command  name  when  issuing  a 
command  line;  CON  requires  only  the  first  three  characters  of  the 
name.  However,  to  make  the  intent  of  the  command  input  clear  to 
someone  reading  a  printed  copy,  you  can  use  the  entire  command  name. 
For  example,  you  can  issue  the  ONLINE  command  as  follows: 

CON>ONL  dev-spec® 


or 

CON>ONLINE  dev-spec  @15 
dev-spec 

The  target  device. 


The  RETURN  key  (the  line  terminator) . 

A  space  or  tab  signals  the  end  of  the  command  name.  Therefore,  no 
spaces  or  tabs  are  permitted  within  the  name  itself.  To  use  the 
reconfiguration  services,  first  invoke  the  command  interface  CON  and 
then  issue  the  commands.  There  are  two  ways  to  invoke  CON 
interactively : 

1.  Use  the  1-line  format  to  invoke  CON,  execute  a  single 
command,  and  return  control  to  MCR.  For  example: 

MCR>CON  command- 1 ine ® 

2.  Use  the  direct  task  format  to  invoke  CON  and  obtain  a  task 
prompt  ( C ON > ) .  For  example: 

MCR>CON  ® 

CON> 

Type  CTRL/Z  to  exit  from  the  direct  task  format. 

You  can  also  enter  commands  through  indirect  command  files.  An 
indirect  command  file  that  contains  reconfiguration  commands  does  not 
require  terminal  interaction  when  the  file  is  executed.  Thus, 
indirect  command  files  are  a  convenient  means  of  creating 
configuration  command  sequences  that  create  different  configurations 
or  restore  previous  configurations. 
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For  example: 

MCR>CON  @CONFIG(RET) 

This  command  line  invokes  CON,  executes  the  reconfiguration  commands 
contained  in  the  indirect  command  file  CONFIG. CMD,  and  returns  control 
to  MCR. 

The  command  line 

CON>  @CONFIG  ffi) 

executes  the  commands  in  the  file  CONFIG.CMD  and  returns  control  to 
CON. 

Indirect  command  files  can  be  nested  to  a  maximum  depth  of  three. 


15.3  CON  COMMAND  SUMMARY 

Table  15-1  summarizes  the  reconfiguration  commands  and  provides  a 
compact  overview  of  the  commands.  Detailed  command  descriptions 
appear  in  alphabetical  order  in  Section  15.4. 


Table  15-1 
CON  Command  Summary 


BUILD 

Creates  a  command  sequence  in  an  internal 
buffer  that,  if  executed,  duplicates  the 
current  system  configuration. 

CLEAR 

Erases  the  command  sequence  created  by 
BUILD  (but  not  the  file  created  by  LIST) 
that  is  stored  in  the  internal  buffer  by 
CON. 

DISPLAY 

Displays  the  configuration  and  status  of 
the  hardware  devices  in  the  current 
system. 

ESTATUS 

Emits  the  current  status  of  a  specific 
device . 

HELP 

Displays  the  help  text  for  CON. 

IDENT 

Displays  the  current  versions  of  CON  and 
HRC  and  the  date  and  time  the  two  tasks 
were  built. 

LINK 

Logically  connects  a  port  of  a  switched 
bus  run  to  a  processor. 

LIST 

Displays  the  results  from  a  BUILD  command 
or  puts  the  command  sequence  into  a 
specified  file.  A  file  type  of  .CMD  is 
suggested  because  that  is  the  default 
type  for  an  indirect  command  file. 

(continued  on  next  page) 
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Table  15-1  (Cont.) 
CON  Command  Summary 


OFFLINE 

Removes  a  device  without  context  from  the 
active  set  of  devices  in  the  current 
configuration. 

OFFLINE  MEMORY 

(Multiprocessor  systems  only.)  Removes 
the  memory  box  with  the  highest  addresses 
from  the  system.  Note  that  you  must 
first  ensure  that  nothing  is  using  the 
memory  in  the  memory  box. 

ONLINE 

Attempts  to  place  a  device  logically  on 
line . 

ONLINE  MEMORY 

(Multiprocessor  systems  only.)  Adds  a 
memory  box  to  the  on-line  configuration. 
Note  that  you  must  expand  the  partition 
structure  to  use  the  additional  memory. 

SET 

Alters  the  CSR  or  interrupt 

address  values  of  a  device  and,  on 

multiprocessor  systems,  activates  or 

inhibits  the  sanity  timer  and  its  alarm. 

SWITCH 

(Multiprocessor  systems  only.)  Logically 
disconnects  a  port  of  a  switched  bus  run 
from  a  processor  and  then  connects  the 
port  to  another  processor.  The  command 
is  equivalent  to  a  LINK  command  followed 
by  an  UNLINK  command. 

UNLINK 

Logically  disconnects  a  port  of  a 

switched  bus  run  from  its  respective 
processor . 

CON  also  accepts  two  switches,  /HE  and  /NOMSG.  These  switches  are 
used  alone  in  the  CON  command  line.  Their  functions  are  as  follows: 

/HE  Displays  the  help  text  for  CON. 

/NOMSG  Suppresses  all  information  displays  and 

error  messages  returned  by  CON.  You  must 
exit  from  and  then  reenter  CON  to  have  the 
messages  be  displayed  again. 
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BUI 


15.4  CON  COMMAND  DESCRIPTIONS 

This  section  describes  each  of  the  reconfiguration  commands.  Note 
that  some  of  the  commands  must  be  issued  from  a  privileged  terminal. 


BUILD 

The  BUILD  command  creates  a  sequence  of  commands  that,  when  executed, 
duplicates  the  current  system  configuration.  The  sequence  of 
reconfiguration  commands  resulting  from  a  BUILD  command  is  held  in  a 
buffer  in  memory.  When  this  sequence  of  commands  executes,  the 
reconfiguration  commands  restore  the  system  to  the  exact  state 
existing  when  the  BUILD  command  was  issued. 

Format 

CON>BUI [LD] 


Example 


CON>BUI LD 

This  command  creates  a  sequence  of  commands  that  duplicates  the 
current  system  configuration. 
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CLEAR 


CLEAR 

The  CLEAR  command  erases  from  the  internal  buffer  the  current  sequence 
of  commands  created  by  the  BUILD  command.  The  command  does  not  delete 
the  file  created  by  the  LIST  command  (described  later  in  this 
section) . 

Format 

CON>CLEAR 


Example 


CON>BUI LD 
CON  >CLEAR 

The  CLEAR  command  removes  from  the  internal  buffer  the  command 
sequence  resulting  from  the  previous  BUILD  command. 
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DIS 


DISPLAY 


The  DISPLAY  command  provides  current  system  configuration  information 
about  the  device  units,  device  controllers,  processors,  memory  boxes, 
and  memory  box  controllers. 

Format 

CON>DIS [PLAY]  [keyword (s)]  [FOR  string] 


Keywords 

UNI [TS] 

Displays  every  device  unit  in  the  current  configuration. 
The  display  equates  each  device  unit  with  its  respective 
controller . 


CON [TROLLERS] 

Displays  every  device  controller  in  the  current 
configuration. 


FUL [L] 

Displays  the  status  flags  for  every  device  unit  and  device 
controller  in  the  current  configuration.  The  status  flags 
indicate  the  following: 

Accpath  The  device  has  an  on-line  access  path. 

Context  For  a  tape  or  disk  (mountable  device) ,  the 

device  contains  a  mounted  volume.  For  a 
terminal,  a  user  is  logged  in.  Other  devices 
are  attached. 

Driver  For  a  device  unit,  the  driver  is  loaded.  For  a 

device  controller,  a  driver  is  available. 


Massbus 

The  device  is  connected  to  an  RH  MASSBUS 
controller . 

Multiport 

The  device  is  dual-ported  (a  dual-access 
device)  between  two  controllers  (for  example,  a 
dual-ported  RP06  drive) . 

Offline 

The  device  is  off  line. 

Online 

The  device  is  on  line  (or  marked  for  on  line) . 

Prv-Diag 

(Used  with  the  OFFLINE  and  ONLINE  keywords.) 
The  device  is  marked  for  on  line  or  off  line, 
but  nothing  can  happen  until  the  respective 
controller  is  brought  on  line  or  taken  off 
line. 

Unknown 

The  CSR  assignment  for  the  device  is  160000  and 
thus  cannot  be  accessed. 

c 


15-9 


RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


DIS  (Cont.) 


ALL 


Same  display  as  for  the  FULL  keyword  with  the  addition  of 
interrupt  vector  addresses  and  CSR  assignments  for  device 
controllers . 

ATT [RIBUTES] 

Displays  interrupt  vector  addresses  and  CSR  assignments  for 
device  controllers. 

The  DISPLAY  command  allows  more  than  one  keyword  per  command 
line.  However,  some  combinations  (such  as  DISPLAY  UNITS  FULL  FOR 
DB)  are  meaningless.  The  DISPLAY  command  ignores  an 

inappropriate  keyword . 

If  the  command  omits  a  keyword,  the  display  contains  the  logical 
names  and  status  flags  for  every  device  unit  and  device 
controller  in  the  current  configuration. 

FOR  string 

An  optional  parameter  that  allows  a  selective  display  of  a 
particular  device  or  device  group.  When  you  use  this  parameter, 
CON  displays  the  requested  information  for  the  devices  specified 
in  the  string. 

You  can  also  use  one  or  two  wildcard  characters  (*)  in  the 
string.  You  use  one  wildcard  to  find  out  which  devices  are 
connected  to  the  controller  you  have  specified  after  the 
wildcard.  You  use  two  wildcards  to  find  out  which  devices  have 
the  attribute  you  have  specified  after  the  wildcards  (either 
ONLINE  or  OFFLINE) . 

For  example: 

CON>DIS  FULL  FOR  RH 

This  command  displays  all  of  the  RH  controllers. 

CON>DI S  FULL  FOR  **ONL 

This  command  checks  to  see  which  devices  have  the  ONLINE 
attribute  (port-specific  status  is  not  displayed)  . 


Examples 

CON>DISPLAY  FULL  FOR  DB 

DBO :  Of f 1 ine , Mult i port ,Massbus , Accpath , Dr iver 

PORT  DBO A  RHBO :  Online 

PORT  DBOB  RHCO:  Onl ine , Cur  rent , Accpath 

DB1 :  Of f 1 ine , Multi port ,Massbus , Accpath , Dr iver 

PORT  DB 1A  RHB1 :  Online 

PORT  DB1B  RHC1:  Onl ine , Cur  rent , Accpath 

This  command  displays  information  about  all  of  the  DB:-type 
devices  configured  into  the  system. 
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DIS  (Cont.) 


CON>DISPLAY  UNITS 


DBO 

DB1 

DRO 

DR1 

MMO 

MM1 

COO 

TTO 

TT1 


RHBO : , RHCO: 
RHB1 : , RHC1 : 
RHAO: 

RHA1 : 

RHD0_0 : 
RHD1_1: 

YLAO : 

YZ  AO : 


TT2 :  YZA1: 
TT3 :  YZA2 : 
VTO: 


DKO 

DK1 

DLO 


DKAO : 
DKA1 : 
DLAO : 


LPO 

LP1 

LP2 

NLO 

DMO 

DM1 


LPAO : 
LPBO : 
LPCO : 


DMAO : 
DMA1 : 


This  command  displays  all  of  the  device  units  and  controllers 
configured  into  the  system. 


15-11 


RSX-11M-PLUS  SYSTEM  RECONFIGURATION 


ESTAT 


ESTATUS 


The  ESTATUS  command  causes  CON  to  exit  with  its  exit  status  word 
reflecting  the  current  status  of  a  specified  device.  Used  with  the 
Indirect  Command  Processor  (Indirect;  see  the  RSX-11M/M-PLUS  MCR 
Operations  Manual) ,  the  command  returns  a  16-bit  word  describing 
device  status.  You  can  use  the  status  word  to  obtain  information 
about  the  configuration.  The  meanings  of  the  bits  in  the  word  are 
given  in  Table  15-2.  Note  that  the  meanings  for  units  and  controllers 
are  different  from  those  for  ports. 


Table  15-2 

Exit  Status  Values  for  CON  ESTATUS 


If  the  status  is  for  a  unit  or  controller: 

Bit 

Bit 

No. 

Value 

Description 

Di splay 

0 

1 

Exit  status  value: 

1 

2 

0  =  Warning 

2 

4 

1  =  Success 

2  =  Error 

4  =  Severe  error 

6 

100 

This  is  a  subcontroller  device. 

7 

200 

This  device  is  a  controller. 

8 

400 

0-device  is  on  line,  1-device  is 

Online 

off  line. 

Offline 

9 

1000 

Device  is  restricted  to  privileged 

Prv  Diag 

and  diagnostic  functions. 

10 

2000 

This  is  a  multiport  device. 

Multiport 

11 

4000 

This  is  a  MASSBUS  device. 

Massbus 

12 

10000 

This  device's  CSR  is  160000 

Unknown 

(unknown) . 

13 

20000 

This  device  has  an  on-line  access 

Accpath 

path. 

14 

40000 

This  device  has  context. 

Context 

15 

100000 

A  driver  is  loaded  for  this  device. 

Driver 

If  the  request 

is  for  a  port: 

Bit 

Bit 

No. 

Value 

Description 

Di splay 

0 

1 

Exit  status  value  (see  above) 

1 

2 

2 

4 

8 

400 

0-port  on  line,  1-port  off  line. 

Online 

Offline 

10 

2000 

This  is  the  current  port. 

Current 

13 

20000 

There  is  an  on-line  access  path  to 

Accpath 

this  port. 

14 

40000 

This  port  or  the  device  it  services 

Context 

• 

has  context. 
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ESTAT  (Cont.) 


Example 


>@TI : 

AT. >. ENABLE  SUBSTITUTION 
AT. >CON  ESTAT  DB1: 

>CON  ESTAT  DB1: 

AT. > ; • <EXSTAT> 1 
>,-  126401 
AT .  >  ~  Z 
>@  <EOF> 

> 


!  Invoke  Indirect. 

!  Enable  substitution  mode. 

!  Type  CON  command  line. 

!  System  displays  command  line. 

!  Request  contents  of  <EXSTAT>  to  be  displayed. 
!  System  displays  current  <EXSTAT>  contents. 

•  Exit  Indirect 


Using  Indirect  interactively ,  the  CON  command  line  emits  the 
current  status  of  DBl:f  which  is  stored  in  the  Indirect  special 
symbol  <EXSTAT>. 

The  number  126401  has  the  following  meaning: 


100000  Device's  driver  loaded. 

20000  Device  has  on-line  access  path. 

6000  Device  is  both  multiport  and  MASSBUS. 

400  Device  is  off  line. 

1  Exit  status  value  =  Success. 


o 
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HE 


HELP 

The  HELP  command  displays  the  help  text  for  CON. 
Format 

CON>HE [ LP] 

Example 

CON>HELP 

CON  —  Configuration  Control  Command  Task 
Implemented  commands : 

ONLINE  <device_l ist> 

ONLINE  MEMORY  Cmemo ry_box> 

ONLINE  ALL 

OFFLINE  <device__l ist> 

OFFLINE  MEMORY  <memory  box> 

OFFLINE  ALL 

SET  <controller_sp 

(User  typed  CTRL/O  to  suppress  further  output.) 
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IDENT 

IDENT 

The  IDENT  command  displays  the  current  version  numbers  of  the  CON  and 
HRC  tasks.  The  date  and  time  the  tasks  were  task-built  are  also 
displayed . 

Format 

CON>IDENT 


Example 


CON>IDENT 

CON  —  CONFIGURE  Version  4.00 
Task  built:  l-DEC-81  12:52:43.5 

HRC  —  HRC  Version  004.000 
Task  built:  15-DEC-81  23:59:10.9 
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LIN 


LINK 

The  LINK  command  logically  connects  a  port  of  a  switched  bus  run  to  a 
processor  and  thus  permits  access  to  the  devices  on  the  switched 
segment  of  the  bus  run. 

To  logically  connect  a  switched  bus  run  to  the  processor's  UNIBUS,  the 
devices  on  the  switched  segment  must  all  be  off  line  or  marked  for  on 
line.  You  cannot  dynamically  link  switched  bus  runs. 

Format 

CON>LINK  UBx  TO  CPx 


UBx 

The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  letter  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE ,  UBF,  UBH,  UBJ,  UBK ,  UBL ,  UBM ,  UBN , 
UBP,  UBR,  UBS ,  and  UBT. 

CPx 


The  target  processor. 


Example 


CON>LINK  UBE  TO  CPA 

This  command  logically  connects  the  first  switched  bus  run  (UBE) 
to  processor  A  (CPA) . 
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LIST 


LIST 

The  LIST  command  displays  the  current  command  sequence  or  writes  the 
sequence  to  a  file.  You  can  use  this  command  to  keep  a  list  of  the 
commands  that  will  duplicate  the  current  configuration.  If  the  buffer 
in  which  the  current  command  sequence  is  stored  (see  the  description 
of  the  BUILD  command)  is  empty,  CON  returns  the  following  message: 

CON  —  Command  list  is  empty.  Nothing  to  print 

If  you  specify  a  . CMD  file  type,  you  can  execute  the  commands  from  the 
indirect  command  file  (that  is,  BUILD,  LIST  filename.CMD,  @filename) 
and  then  return  to  CON. 

Format 

CON>LIST  [filespec] 
f ilespec 

Any  legal  RSX-11M-PLUS  file  specification  in  the  form 
ddnn: [ggg,mmm] filename .type ; version. 


Example 


CON>BUI LD 
CON>LIST 


ONLINE 

RHA 

ONLINE 

RHB 

ONLINE 

RHC 

OFFLINE 

DMA 

OFFLINE 

YLA 

ONLINE 

YZA 

ONLINE 

DKA 

ONLINE 

DLA 

ONLINE 

LPA 

ONLINE 

DBO : 

ONLINE 

DB1: 

ONLINE 

DRO: 

ONLINE 

DR1 : 

ONLINE 

MMO: 

ONLINE 

MM1 : 

ONLINE 

COO: 

ONLINE 

TTO : 

ONLINE 

TT1 : 

ONLINE 

TT2 : 

ONLINE 

TT3 : 

ONLINE 

TT4 : 

ONLINE 

TT5 : 

ONLINE 

TT6 : 

ONLINE 

TT7 : 

ONLINE 

TT10 

ONLINE 

DKO : 

ONLINE 

DK1 : 

ONLINE 

DLO : 

ONLINE 

LPO : 

ONLINE 

NLO : 

ONLINE 

DM0: 

ONLINE 

DM1: 
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OFF 


OFFLINE 


The  OFFLINE  command  changes  the  state  of  a  quiet  device  to  off-line, 
thus  removing  the  device  from  the  active  set  of  resources  in  the 
current  system  configuration.  This  prevents  further  device  access. 
To  take  a  device  off  line,  it  must  not  have  context  (see  Section 
15.1.3),  and  HRC  must  be  able,  in  1000(10)  tries  or  less,  to  catch  the 
device  when  there  is  no  I/O  activity  in  progress. 

The  transition  to  the  off-line  state  for  a  specific  device  controller 
is  completed  only  if  all  associated  devices  are  also  off  line.  If  an 
associated  device  is  not  off  line,  HRC  rejects  the  OFFLINE  command 
because  placing  the  device  off  line  could  interfere  with  active  I/O. 

Issue  the  appropriate  MCR  command (s)  to  remove  device  context.  This 
ensures  that  the  device  does  not  have  context  and  can  be  placed  off 
line. 

If  a  task  has  attached  the  device  unit,  the  task  must  be  detached  (or 
request  to  be  aborted)  before  the  unit  can  be  placed  off  line. 

For  example,  if  you  issue  an  OFFLINE  command  for  a  line  printer 
controller  (such  as  OFF  LPB) ,  and  a  connected  unit  (such  as  LP1:)  has 
context  (in  this  case,  LP1:  is  a  spooled  device  and  attached  by  the 
Queue  Manager) ,  CON  rejects  the  command  and  issues  the  following  error 
message : 

**Unable  to  take  unit  with  context  offline 

If  the  device  is  marked  for  on  line  (for  example,  a  device  unit  with 
its  controller  off  line) ,  the  command  changes  the  device  state  to 
off-line.  Subsequently,  when  the  controller  is  brought  on  line,  the 
system  does  not  activate  the  device. 

If  the  device  is  marked  for  off  line,  the  command  changes  the  device 
state  to  off-line  and  thus  enables  a  future  on-line  attempt. 

Individual  ports  of  dual-port  devices  can  be  taken  off  line 
separately.  You  may  want  to  do  this  if  the  port  does  not  work 
correctly  (for  example,  you  cannot  access  the  device  through  the  port) 
or  if  you  want  to  increase  system  throughput.  Figure  15-1  is  an 
example  of  the  way  throughput  could  be  increased: 


RHB 


DBOA 


RHA 


DB1 A 


ZK-575-81 


Figure  15-1  Sample  Configuration  for  Increasing  System  Throughput 
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OFF  (Cont.) 


With  this  configuration,  it  is  probable  that  the  system  will  use  the 
DBOA  port.  Because  activity  on  DB1 :  must  use  the  DB1A  port,  it  has 
to  wait  until  DBOA  is  free.  If  you  put  only  ports  DBOB  and  DB1A  on 
line,  each  DB  disk  has  its  own  controller  and  does  not  have  to  wait 
for  another  port  to  be  free. 

The  OFFLINE  command  also  accepts  an  optional  keyword,  ALL,  which 
places  off  line  all  devices  except  the  system  disk  and  the  terminal 
that  issued  the  command.  (The  OFFLINE  ALL  command  is  useful  prior  to 
a  system  save.)  Before  issuing  the  OFFLINE  ALL  command,  you  must  first 
dismount  all  volumes  (tapes  and  disks)  except  the  system  disk  and  log 
out  all  terminals  except  the  issuing  terminal. 


Formats 


CON>OFF [LINE]  device-sped [ ,device-spec2 . . . ,device-specn] 
CON>OFF [LINE]  ALL 

Note  that  device-spec  also  includes  processors  (CPx) . 

Requi rements 

1.  Only  a  privileged  user  can  modify  the  system  configuration. 

2.  No  tasks  are  attached  to  the  device. 

3.  No  volumes  are  mounted  on  the  device. 

4.  If  the  device  is  a  terminal,  no  users  are  logged  in  on  it. 


Example 


CON>OFFLINE  LPA,LP0: 
CON>OFF  YZA,YZB,YZC,YZD 


!  Terminals  assumed  not  logged  in 


The  command  sequence  logically  places  the  devices  off  line,  which 
allows  the  bus  run  UBE  to  be  placed  off  line. 
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OFF  MEM 


OFFLINE  MEMORY 

(Multiprocessor  systems  only.)  The  OFFLINE  MEMORY  command  removes  a 
memory  box  from  the  system  configuration.  Because  memory  must  be 
contiguous,  the  target  box  must  be  the  memory  box  in  the  system 
configuration  with  the  highest  addresses  (the  last  memory  box  added  to 
the  system) .  If  the  target  box  is  not  the  last  box  in  the  memory 
configuration,  CON  rejects  the  command  and  issues  the  message: 

**HRC . . .  Can't  take  box  offline.  Not  last  box  in  memory 

If  a  partition  maps  to  a  memory  box  targeted  for  off-line  status,  CON 
rejects  the  command  and  issues  the  following  message: 

**HRC . . .  Can't  take  box  offline.  Partition  overmaps  box 

Therefore,  you  must  contract  the  partition  structure  before  removing 

the  memory  box.  The  MCR  SET  /TOP  command  can  adjust  the  partition 

structure  up  or  down  (see  the  RSX-11M/M-PLUS  MCR  Operations  Manual  for 
details),  but  it  is  your  responsibility  to  ensure  that  nothing  is 

using  the  memory  in  the  memory  box.  The  system  is  protected  so  that 

you  cannot  bring  the  memory  box  off  line  if  anything  is  using  it. 

Format 

CON>OFF [LINE]  MEM[ORY]  memory-box 


Example 


CON>OFF  MEM  MK2 : 

This  command  removes  memory  box  MK2 :  from  the  system 

configuration. 
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ONL 


ONLINE 

The  ONLINE  command  changes  the  state  of  a  device  to  on  line  and 
enables  device  access. 

The  transition  to  the  on-line  state  is  completed  only  if  an  access 
path  exists  between  the  device  and  the  processor,  and  if  the  device 
driver  can  successfully  initialize  the  device. 

If  the  device  lacks  an  access  path,  the  ONLINE  command  changes  device 
state  to  marked  for  on-line;  the  device  is  activated  when  an  on-line 
access  path  becomes  available  (when  the  controller  is  brought  on 
line) . 

The  ONLINE  command  also  accepts  an  optional  keyword,  ALL,  which  places 
logically  on  line  every  device  controller  and  device  unit  known  to  the 
system. 

Note  that  the  data  base  values  for  interrupt  vector  and  CSR 
assignments  have  no  effect  on  the  system  until  the  device  is  brought 
on  line. 

Formats 

CON>ONL [ INE]  device-sped [ ,device-spec2 . . . ,device-specn] 

CON>ONL [ INE]  ALL 
Requirements 

1.  Only  a  privileged  user  can  modify  the  system  configuration. 

2.  The  specified  device  must  be  physically  present  in  the  target 
system  and  included  in  the  system  at  system  generation. 

3.  If  the  specified  device  is  serviced  by  a  loadable  driver,  the 
driver  and  device  data  base  must  be  loaded. 

The  ONLINE  command  activates  a  device  unit  only  if  the  associated 
controller  is  on  line.  The  command  first  tests  the  unit  to  determine 
whether  it  actually  exists  on  the  controller  and  then  performs  drive 
sizing  to  determine  device  unit  type.  If  the  unit  exists,  it  is  now 
ready  for  user  access.  If  the  associated  controller  is  off  line,  the 
command  marks  the  unit  for  on-line  status;  it  is  presence-tested  and 
sized  when  the  access  path  is  completed  and,  if  present,  activated. 

To  activate  a  device  controller,  the  ONLINE  command  tests  the 
controller's  status  register  (CSR)  to  determine  whether  it  is 
physically  present.  If  the  controller  is  present,  then  all  of  the 
associated  units  that  are  marked  for  on-line  status  are 
presence— tested ,  sized,  and  brought  on  line.  Off-line  units  remain  in 
the  relative  off-line  state  regardless  of  any  ONLINE  command  performed 
on  the  associated  controller. 

To  activate  a  processor  on  multiprocessor  systems,  the  ONLINE  command 
issues  a  boot  request  to  the  target  processor.  If  the  target 
processor  ignores  the  boot  request  or  cannot  boot  successfully,  CON 
issues  the  following  message  (after  a  timeout  of  5  seconds) : 

**Command  execution  error.  Device  offline 
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ONL  (Cont.) 


You  can  also  bring  on  line  individually  the  ports  of  a  dual-port 
device,  thus  increasing  system  throughput  because  you  do  not  have  to 
wait  for  both  ports  if  one  does  not  work. 

For  dual-port  terminals,  you  need  a  Status  Control  Block  (SCB)  for 
each  terminal  to  bring  the  ports  of  dual-port  terminals  on  line 

individually  and  to  switch  them  individually.  To  switch  the  ports, 

the  software  will  bring  the  controller  on  line,  but  the  terminals  must 
be  switched  manually  using  the  CS11  switch  on  each  terminal.  If  you 

have  only  one  SCB  for  each  controller,  all  of  the  terminals  on  a 

controller  have  to  be  switched  over  to  the  same  controller. 

Examples 

The  following  command  sequence  (used  on  a  multiprocessor  system) 
assumes  that  the  UBE  bus  run  has  been  switched  from  CPA  to  CPB. 
The  commands  place  the  software  bus  devices  on  line  for  access: 

CON > ONLINE  LPA,LP0:  !  On  line  line  printer  and  controller 

CON>ONL  YZA, YZB, YZC, YZD  !  On  line  terminal  interfaces 

CON>ONL  TT2: ,TT3: ,TT4: ,TT5:  !  On  line  terminals 

CON>ONL  TT6 : , TT7 : , TT1 0 : , TT1 1 : 


The  following  command  places  all  devices  on  the  system  logically 
on  line: 

CON>ONL  ALL 

This  command  places  on  line  every  device  controller  and  device 
unit  (except  CPUs)  known  to  the  system  (that  is,  all  controllers 
and  devices  included  at  system  generation) .  If  a  device  unit  or 
device  controller  lacks  an  access  path,  the  command  marks  these 
for  on-line  status. 

Note  that  placing  all  devices  on  line  takes  several  seconds  on  a 
large  system  and  that  the  command  does  not  generate  any  error 
messages  saying  that  a  device  may  not  be  on  line. 
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ONL  MEM 


ONLINE  MEMORY 


(Multiprocessor  systems  only.)  The  ONLINE  MEMORY  command  adds  a  memory 
box  to  the  system  configuration.  To  place  the  additional  memory  on 
line,  you  must  first  place  the  appropriate  memory  box  port  controllers 
and  the  memory  box  itself  logically  on  line.  The  box  you  specify  will 
have  the  highest  memory  addresses. 


To  use  the  additional  memory,  you  must  expand  the  partition  structure 
with  the  MCR  SET  /TOP  command  (see  the  RSX-1 1M/M-PLUS  MCR  Operations 
Manual)  . 

Format 


CON>ONLINE  MEMORY  memory-box 


Example 

CON> ONLINE  MEMORY  MK2 : 

This  command  adds  the  memory  box  MK2 :  to  the  system 

configuration . 
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SET 


SET 

The  SET  command  changes  the  value  of  the  CSR  or  the  interrupt  vector 
address  for  an  off-line  device.  The  values  are  stored  in  the  device 
driver's  data  base. 

SET  cannot  verify  the  CSR  or  interrupt  vector  address  that  you 
specify.  If  you  specify  an  incorrect  CSR  address,  the  system  will  not 
be  able  to  access  the  device  when  you  issue  the  ONLINE  command  for  the 
device.  If  you  specify  an  incorrect  interrupt  vector  address,  the 
system  will  send  interrupts  to  nonexistent  interrupt  vectors  when  you 
place  the  device  logically  on  line;  the  device  cannot  be  accessed. 
Also,  if  you  specify  an  interrupt  vector  that  is  in  use,  you  will  get 
an  error  when  you  attempt  to  place  the  controller  on  line.  (See  the 
RSX-1 1M-PLUS  Guide  to  Writing  an  I/O  Driver  for  descriptions  of  the 
CSR  and  vector  assignment  errors.) 

On  multiprocessor  systems,  the  SET  command  also  activates  the  sanity 
timer  and  enables  an  alarm  if  the  timer  expires. 

Format 

CON>SET  controller  option=value 
controller 


The  device 

controller  (for  example,  RHA  or  DMA). 

option 

One  of  the 

following : 

CSR 

Alters  the  value  of  the  controller's 
stored  in  the  driver  data  base. 

CSR 

address 

VEC 

Alters  the  value  of  the  controller's  interrupt  vector 
address  stored  in  the  driver  data  base. 

TIMER 

(Multiprocessor  systems  only.)  Activates 
the  sanity  timer  (controller  is  RHx) . 

or 

inhibits 

ALARM 

(Multiprocessor  systems  only.)  Activates 

or 

inhibits 

an  alarm  upon  sanity  timer  timeout  (controller  is 
RHx )  . 


value 


If  the  SET  option  is  CSR,  the  value  must  be  between  160000(8)  and 
177777(8).  Note  that  if  you  specify  a  CSR  address  of  160000  or 
less,  the  device  is  "unknown”  and  cannot  be  placed  on  line.  This 
allows  you  to  use  the  CON  ONLINE  ALL  command  without  bringing 
every  device  on  line  when  the  current  hardware  configuration 
differs  from  the  generated  system.  For  example,  if  the  target 
system  has  a  DMC11  with  a  CSR  address  of  160100,  but  the 
generated  system  has  a  DZ11  at  that  address,  CON  ONL  ALL  attempts 
to  bring  the  DMC11  on  line  as  a  DZ11.  Note  that  the  attempt  may 
crash  the  system. 
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SET  (Cont.) 


If 


the  SET  option 


is  VEC, 


the  value  must  be  less  than  774(8). 


On  multiprocessor  systems,  if  the  SET  option  is  TIMER  or  ALARM, 
the  value  is  either  ON  (to  activate)  or  OFF  (to  inhibit) . 

Requirements 


The  device  must  be  off  line  and  the  driver  must  be  loaded. 


Examples 


CON>SET  LPA  VEC=1 60 

This  command  changes  the  interrupt  vector  address  for  the  first 
line  printer  controller  to  160(8). 


CON>SET  LPA  CSR=1 77600 

This  command  changes  the  CSR  address  for  the  first  line  printer 
controller  to  177600(8). 


€ 
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SWI 


SWITCH 

(Multiprocessor  systems  only.)  The  SWITCH  command  logically  inverts 
the  processor  association  of  a  switched  bus  run;  that  is,  it  performs 
an  unlink  operation  followed  by  a  link  operation.  The  command  uses  a 
special  hardware  feature  of  the  DT07  to  guarantee  that  the  switched 
bus  is  linked  to  the  target  processor  after  the  unlink  operation. 
Thus,  the  SWITCH  command  ensures  that  the  switched  bus  will  be 
logically  connected  to  the  desired  processor. 

For  example,  in  a  3-processor  system,  a  properly  configured  switched 
bus  can  be  connected  to  any  one  of  three  processors.  An  UNLINK 
command  permits  any  processor  to  then  link  the  switched  bus.  However, 
the  SWITCH  command  specifies  that  only  a  specific  processor  can  link 
the  switched  bus  run  following  the  unlink  operation.  If  CPA  and  CPB 
are  running  as  a  dual-processor  system  and  CPC  is  a  single-processor 
system,  a  switch  from  CPA  to  CPB  occurs  even  if  CPC  is  trying  to  gain 
control  of  the  bus. 

CON  rejects  the  command  if  a  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 


CON>SWITCH  UBx  TO  CPx 


UBx 


The  target-switched  bus  run.  Switched  bus  runs  are  named  using 
the  designation  UB  followed  by  a  letter  from  the  DIGITAL  hardware 
alphabet  as  follows:  UBE,  UBF ,  UBH,  UBJ,  UBK ,  UBL ,  UBM ,  UBN , 
UBP ,  UBR ,  UBS,  and  UBT. 

CPx 

The  target  processor. 


Example 

CON>OFF  LPA , LPO : 

CON>OFF  YZA, YZB, YZC,YZD 
CON>OFF  TT2 : , TT3 : , TT4 : , TT5 : 
CON>OFF  TT6: ,TT7: ,TT10: ,TT11: 
CON>SWITCH  UBE  TO  CPB 
CON>ONL  LPA, LPO: 

CON>ONL  YZA,YZB,YZC,YZD 
CON>ONL  TT2 : , TT3 : , TT4 : , TT5 : , 
CON>ONL  TT6: ,TT7: ,TT10: ,TT11: 


!  Off  line  printer  and  controller 
!  Off  line  terminal  interfaces 
!  Off  line  all  terminals 

!  Terminals  assumed  not  logged  in 

!  On  line  line  printer  and  controller 

!  On  line  terminal  interfaces 

!  On  line  terminals 

!  (Devices  now  connected  to  CPB) 


This  command  sequence  logically  disconnects  the  first  switched 
bus  run  (UBE)  from  its  respective  processor  and  then  logically 
connects  UBE  to  processor  B. 
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UNL 


UNLINK 

The  UNLINK  command  disconnects  a  port  of  a  switched  bus  run  from  its 
respective  processor.  This  command  reverses  the  effect  of  the  LINK 
command . 

CON  rejects  the  command  if  any  device  attached  to  the  switched  bus  has 
context  (that  is,  the  device  is  processing  or  allowing  processing  of 
I/O)  . 

Format 

CON>UNLINK  UBx 


UBx 


The  switched  bus. 


Example 

CON>UNL  UBE  !  Terminals  assumed  not  logged  in 

This  command  disconnects  the  switched  bus  port  of  UBE  from  its 
respective  processor. 
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15.5  SYSTEM  FAULTS 

System  faults  cause  an  RSX-11M-PLUS  system  to  stop  processing  an 
application  properly.  A  fault  could  be  a  user  error,  a  system 
software  failure,  an  application  software  error,  or  a  hardware  fault. 
User  errors  (for  example,  accidentally  removing  a  disk  from  the 
system)  are  obvious  because  the  fault  usually  occurs  immediately  after 
the  user  action.  System  software  failures  usually  occur  when  a  system 
bug  is  encountered  while  you  are  debugging  the  application  software. 
Application  software  errors  are  application-specific  and  not  discussed 
in  this  manual.  Hardware  faults  —  their  detection,  isolation,  and 
recovery  from  —  are  discussed  in  the  remainder  of  this  chapter. 


15.5.1  Hardware  Faults 

Hardware  faults  can  be  placed  in  the  following  categories: 

•  Media  failures 

•  Transient  failures 

•  Intermittent  failures 

•  Soft  errors 

•  Hard  errors 

The  following  sections  describe  each  of  these  types  of  faults. 


15.5.1.1  Media  Failures  -  Media  failures  occur  when  I/O  operations 
fail  because  portions  of  the  medium  (a  disk  or  tape)  are  bad.  For 
both  disks  and  tapes,  when  a  media  failure  is  detected,  read 
operations  are  retried. 

Before  disks  are  initialized,  you  should  check  them  for  faulty  sectors 
with  the  BAD  utility.  BAD  marks  the  bad  sectors,  which  prevents  the 
file  system  from  using  them.  (See  the  RSX-11M/M-PLUS  Utilities  Manual 
for  more  information.) 

Occasionally,  sectors  on  the  media  become  bad,  causing  I/O  operations 
to  those  sectors  to  fail.  The  error  logging  system  can  be  used  to 
detect  these  failures.  (See  the  RSX-11M/M-PLUS  Error  Logging  Manual 
for  more  information.)  You  should  probably  replace  faulty  media  if 
they  have  critical  data  recorded  on  them  or  if  a  large  number  of 
errors  occur  on  them. 

On  devices  supported  by  DUDRV ,  bad  blocks  may  be  replaced  by  the  Bad 
Block  Replacement  Control  Task  (RCT) .  See  Chapter  5  for  more 
information  on  this  process. 


15.5.1.2  Transient  Failures  -  Transient  failures  cannot  be  repeated 
and  are  caused  by  electrical  factors  such  as  static  from  clothing  or 
carpeting.  If  the  failure  occurs  on  an  I/O  device,  the  I/O  operation 
is  retried  automatically  and  the  application  software  never  sees  the 
failure.  (The  Error  Logger  records  the  failure,  however.)  If  the 
failure  occurs  in  memory  or  in  a  central  processor,  the  system  may 
crash  and  have  to  be  rebooted. 
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15.5.1.3  Intermittent  Failures  -  Intermittent  failures  are  caused  by 
irregular  conditions  within  the  system  and  usually  happen  during 
periods  of  high  system  or  device  activity.  The  failures  usually  occur 
where  recorded  data  is  corrupted  enough  so  that  it  cannot  be  read. 
The  data  becomes  corrupted  when  the  device  on  which  it  is  recorded  is 
not  working  properly,  usually  because  of  a  temporary  power  shortage. 

An  example  of  an  intermittent  failure  is  a  disk  device  detecting  a 
power  failure,  which  causes  the  disk's  volume  valid  bit  to  be  reset. 
Dismounting  and  remounting  the  disk  clears  this  condition  and  may 
allow  I/O  operations  to  proceed. 

If  the  sources  of  intermittent  failures  are  not  obvious  or  directly 
reproducible,  try  to  recreate  the  conditions  that  caused  the  failure 
by  using  the  I/O  Exerciser  (IOX).  IOX  simulates  high  system  activity, 
which  could  cause  the  failure  to  recur.  (See  Chapter  4  for 
information  on  IOX) . 

Intermittent  failures  that  result  in  device  errors  appear  in  the  error 
log . 


15.5.1.4  Soft  Errors  -  Soft  errors  are  device  errors  that  do  not 
prevent  an  I/O  operation  from  completing  successfully.  The  device 
driver  retries  the  operation  and,  depending  on  the  capabilities  of  the 
device,  performs  ECC  correction  or  disk-head  offset  positioning. 

Soft  errors  usually  indicate  poor  media  or  a  misaligned  device.  For 
example,  disk  heads  that  are  not  aligned  properly  cause  disk  errors. 
These  errors  can  be  corrected  by  head  offset  positioning. 

If  several  soft  errors  occur  on  a  device,  you  should  find  the  source 
of  the  errors  and  correct  it  through  field  service  maintenance. 

Soft  errors  are  recorded  by  the  Error  Logger. 


15.5.1.5  Hard  Errors  -  Hard  errors  are  solid  device  failures  that 
prevent  a  device  from  working  properly.  The  errors  make  the  device 
unusable,  but  they  are  also  the  easiest  to  diagnose  and  correct. 

The\ Error  Logger  records  failed  operations  on  the  disks  and  tapes,  but 
that  information  is  usually  unnecessary  since  the  failures  are 
obvious . 

You  can  also  use  IOX  to  test  the  capabilities  of  many  peripheral 
devices  to  determine  if  they  are  failing. 


15.5.2  Recoverable  and  Nonrecoverable  Errors 

Soft  errors  and  many  media  errors  are  recoverable  errors.  They  are 
recorded  by  the  Error  Logger  but  do  not  impact  system  operation. 

Hard  errors  and  some  media  errors  are  nonrecoverable  errors.  They 
usually  result  in  recurring  device  errors  and  failure  of  the 
application  software.  (The  application  can  survive  one  failure  on 
each  device  type  before  it  will  stop  processing  completely.)  However, 
the  operating  system  itself  often  survives  the  failure  because  all  it 
requires  to  continue  running  is  the  system  disk,  the  central 
processor (s) ,  and  memory. 
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15.6  FAULT  ISOLATION 

Once  the  software  is  stable,  the  availability  of  a  system  depends  on 
the  reliability  of  individual  devices  and  the  time  required  to  restore 
processing.  RSX-11M-PLUS  systems  can,  in  some  cases,  work  around 
equipment  failures  in  individual  devices,  but  you  must  eventually 
isolate  a  faulty  device,  correct  the  reason  for  the  failure,  and 
restore  it  to  the  system.  Depending  on  the  severity  and  location  of 
the  error,  you  may  have  to  restart  the  application  and/or  the  system. 

Failures  often  exhibit  symptoms  that  allow  you  to  detect  a  failing 
device  before  it  can  disrupt  system  operation.  Because  of  this,  you 
should  regularly  monitor  the  condition  of  all  RSX-11M-PLUS  peripherals 
and  their  ability  to  respond  correctly  to  I/O  requests  by  periodically 
examining  the  error  log  reports  on  all  devices  and  occasionally 
running  IOX  on  infrequently  used  devices.  The  Error  Logger  gathers 
information  concerning  all  types  of  errors  as  they  occur  and  generates 
comprehensive  error  reports.  IOX  tests  the  validity  of  mass  storage 
devices.  The  tests  exercise  combinations  of  devices  under  high  I/O 
activity.  ' 

Both  the  Error  Logger  and  IOX  provide  error  reports  that  contain  a 
description  of  device  fault  conditions.  Use  the  reports  to  determine 
whether  the  device  should  remain  in  operation.  If  the  fault 
conditions  are  transient  (see  Section  15.5.1.2)  and  the  device  is 
capable  of  correctly  performing  its  I/O  functions,  the  device  can 
remain  in  operation.  However,  you  should  closely  monitor  the  device 
and  schedule  it  for  future  maintenance  as  required. 


15.7  SYSTEM  RECOVERY 

The  procedure  you  use  to  diagnose  and  recover  from  a  system  fault 
depends  on  the  primary  use  of  your  system.  If  it  is  mainly  used  for 
application  development,  then  you  would  want  to  use  the  Error  Logger 
or  IOX  to  determine  the  cause  of  a  failure  to  prevent  future  failures. 
If  your  system  is  used  for  process  control  and  is  running  an 
application  that  requires  enhanced  availability,  utilities  such  as  the 
Executive  Debugging  Tool  (XDT)  are  necessary  only  as  much  as  they  can 
be  used  to  isolate  and  correct  failed  components.  Your  main  objective 
is  to  bring  the  system  back  up  and  restart  the  application,  with  only 
limited  diagnostics  for  future  references. 

To  restart  the  system  and  the  application,  first  bring  up  the  minimum 
system  required  for  running  RSX-11M-PLUS .  Then  gradually  bring 
devices  on  line  until  you  have  the  minimum  system  required  for  running 
the  application.  If  any  of  the  devices  are  faulty,  you  can  take  them 
back  out  of  the  system  and  bring  others  on  line  until  you  have  the 
required  configuration. 

The  method  for  recovering  from  system  faults  also  depends  on  the  type 
of  fault.  Transient  errors  could  cause  the  system  to  crash,  which 
would  require  rebooting.  Hard  errors  require  the  device  not  to  be 
used  and  possibly  to  be  reconfigured  out  of  the  system  so  that 
diagnostics  for  it  can  be  run.  Intermittent  errors,  because  their 
source  is  not  so  obvious,  could  require  you  to  begin  with  a  minimum 
configuration  and  then  gradually  add  devices  until  you  find  the  one 
that  caused  the  error.  If  the  minimum  configuration  has  the  problem, 
you  will  have  to  switch  to  another  one.  Another  possible  way  to 
recover  from  intermittent  failures  is  to  turn  the  error  into  a  hard 
error  by  imposing  an  appropriate  system  load  using  IOX.  By  recreating 
the  error,  you  can  discover  its  source  and,  therefore,  how  to  correct 
it. 

The  following  sections  describe  how  to  recover  from  different  kinds  of 
hardware  failures. 
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15.7.1  Device  Unit  and  Controller  Failures 

Most  failures  in  an  operating  system  result  from  disk,  tape,  or  other 
such  device  failures.  Either  the  units  themselves  fail  or  the 
respective  controller  fails. 

The  time  needed  to  reconfigure  around  these  failures  depends  entirely 
on  the  application.  If  the  application  can  notify  an  operator  of  the 
failure,  thus  allowing  the  operator  to  remove  and  inspect  the  media, 
mount  it  on  another  drive,  and  reintegrate  it  into  the  system,  then 
the  time  to  reconfigure  is  short.  If,  on  the  other  hand,  the  operator 
must  find  a  way  to  halt  the  application,  move  the  media,  and  restart, 
then  the  time  to  reconfigure  increases. 

On  RSX-1 1M-PLUS  systems,  TKTN  prints  a  message  at  the  console  terminal 
whenever  an  unrecoverable  hardware  error  occurs.  For  example: 

***  DB1 :  —  Unrecoverable  hardware  device  error 

These  messages  can  alert  an  operator  to  an  impending  failure  and  allow 
time  to  issue  the  commands  to  remove  the  failing  unit  from  the  system. 


15.7.2  Processor  Failures 

Although  it  occurs  rarely  in  comparison  with  device  unit  and 
controller  failures,  a  processor  failure  also  halts  system  operation. 

Note  that,  on  multiprocessor  systems,  a  crash  or  trap  or  other  failure 
may  occur  on  a  processor  other  than  the  faulty  one. 

If  'a  processor  fails,  the  system  usually  exhibits  one  of  the  following 
symptoms : 

•  The  system  traps  to  XDT  or  crashes. 

•  The  sanity  timer  expires  for  one  or  more  processors 

(multiprocessor  systems  only) . 

•  The  console  lights  on  nonremote  diagnostic  consoles  show  that 
the  system  is  halted  in  the  Executive. 

•  The  system  halts  with  no  printouts  or  visual  indicators. 

On  multiprocessor  systems,  regardless  of  the  cause  of  a  processor 
failure,  the  recovery  technique  is  straightforward  and  direct:  you 
must  isolate  and  exclude  the  disabled  processor  and  reboot  the  system. 
The  memory  configuration  need  not  change  unless  you  wish  to  perform 
stand-alone  diagnostics  (see  Section  15.8)  on  the  failed  processor. 


15.7.3  MK11  Memory  Box  Failures 

The  two  most  common  causes  of  memory  failures  are  uncor rectable 
double-bit  errors  (parity  errors)  and  loss  of  memory  power. 

If  a  user-state  task  encounters  an  uncor rectable  memory  parity  error, 
the  system  aborts  the  task  and  locks  that  portion  of  memory.  The 
Fixer  task  ( FXR)  detects  the  parity  errors  and  creates  a  distinct 
segment  in  the  task's  region  using  the  memory  in  which  the  errors  were 
detected.  This  segment  is  separate  from  the  rest  of  the  region  and  is 
not  used  by  other  tasks.  FXR  is  completely  transparent  to  both  users 
and  tasks. 


15-31 


RSX-1 1M-PLUS  SYSTEM  RECONFIGURATION 


If  the  Executive  or  a  system-state  task  encounters  an  uncorrectable 
parity  error,  the  system  prints  the  following  message  and  then  halts: 

***EXEC  PARITY  ERROR  STOP 

A1  so  ,  the  sanity  timers  on  multiprocessing  systems  may  expire. 

Regardless  of  system  state  (user  or  kernel)  ,  a  double-bit  error  causes 
the  memory  box  hardware  to  light  the  UNCOR  ERROR  light (s)  on  the 
respective  memory  box  port  controllers. 

When  an  uncorrectable  error  halts  the  system,  you  must  manually 
exclude  that  memory  box  and  reboot.  First,  switch  all  ports  of  the 
faulty  box  off  line.  If  necessary,  use  the  thumbwheel  switches  to 
properly  address  the  remaining  memory  box(es).  (The  thumbwheel 
switches  are  used  when  the  failed  box  is  box  0,  which  is  the  boot  box, 
or  when  you  want  to  disable  a  memory  box  by  changing  the  starting 
addresses  of  the  remaining  boxes.)  Then,  halt  the  processor, 
initialize  it,  and  reboot  the  system. 

When  loss  of  power  causes  the  memory  failure,  the  system  halts.  The 
system  exhibits  one  or  more  of  the  following  symptoms: 

1.  No  lights  or  indicators  are  lit  -  usually  indicates  that  the 
outside  power  supply  has  failed. 

2.  No  MEM  POWER  READY  lights  are  lit  on  memory  box  -  indicates 
that  the  memory  box's  power  supply  has  failed  or  has  been 
powered  down  (check  the  power  switch  on  the  Port  A  controller 
to  the  box)  . 

3.  No  MEM  POWER  READY  lights  are  lit  on  one  port  of  all  memory 
boxes  -  indicates  that  the  CPU's  power  supply  has  failed  or 
the  CPU  has  been  powered  down.  Note  that  the  power  supply 
failure  could  have  come  through  an  expander  box  or  through 
the  far  side  of  a  switched  bus  currently  switched  to  the  CPU. 

In  all  of  the  above  cases,  if  a  CPU  or  a  memory  box  has  been  switched 
off  but  then  switched  back  on  before  the  memory  batteries  discharge, 
the  system  usually  recovers  without  rebooting. 

Otherwise,  to  recover  from  a  memory  box  power  failure,  first  manually 
switch  all  ports  of  the  failed  box  off  line.  If  necessary,  use  the 
thumbwheel  switches  to  properly  address  the  remaining  memory  box(es). 
Then,  halt  and  initialize  the  processor(s)  and  reboot  the  system. 


15.8  STAND-ALONE  MAINTENANCE  FOR  MULTIPROCESSOR  SYSTEMS 

On  multiprocessing  systems,  when  a  device  fails,  it  is  often  necessary 
to  run  diagnostic  tasks  before  servicing  the  device.  However,  the 
diagnostic  tasks  require  a  processor  for  execution.  Thus,  to  service 
most  devices,  you  must  remove  a  processor  from  the  system. 

The  following  list  gives  the  requirements  for  testing  and  servicing 
peripheral  devices: 

1.  A  processor  must  be  available  to  execute  the  diagnostics  for 
the  peripheral. 

2.  Memory  must  be  available  for  the  diagnostics. 

3.  A  mechanism  to  load  the  diagnostic  task  into  memory  must  be 
available. 
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The  processor  that  executes  the  diagnostics  must  be  connected  to  the 
UNIBUS  on  which  the  device  to  be  tested  resides.  This  implies  that 
other  peripherals  on  that  bus  run  will  not  be  available  to  the 
remainder  of  the  system.  Therefore,  when  determining  the  initial 
system  conf igurat ion ,  you  must  ensure  that  duplicate  devices  are 
located  on  distinct  bus  runs.  If  the  device  to  be  tested  is  on  a 
switched  bus  run,  the  switched  bus  can  be  connected  to  any  processor 
to  which  it  has  access. 

To  make  memory  available  for  diagnostic  tasks,  the  usual  procedure  is 
to  logically  remove  a  memory  box  from  the  running  system  and  use  the 
box  for  diagnostics  only.  This  memory  box  is  then  switched  manually 
so  that  the  processor  to  be  used  for  diagnostics  views  the  box  with  a 
starting  address  of  0. 

For  loading  a  diagnostic  into  memory,  the  RSX-11M-PLUS  multiprocessor 
system  provides  the  Diagnostic  Loader  task  (DLD) .  DLD  loads  a 
diagnostic  program  into  a  partition  in  the  memory  box  of  the 

diagnostic  processor  (the  processor  to  which  the  failed  device  is 
attached) .  Diagnostic  programs  are  system  image  files  that  you  use  to 
test  the  failed  devices.  The  partition  is  created  and  specified  by 
you  and  is  mapped  by  program  logical  address  space  (PLAS)  directives. 
By  default,  DLD  clears  the  partition  to  the  end  after  loading  the 

program.  The  diagnostic  is  then  run  stand-alone. 

The  steps  for  using  DLD  are  as  follows: 

1.  Use  FLX  to  transfer  the  diagnostic  program  from  the 

diagnostic  tape  or  disk  to  a  Files-11  device  attached  to  the 
diagnostic  processor.  (See  the  RSX-1 1 M/M- PLUS  Utilities 
Manual  for  information  on  FLX.)  Because  the  tape  or  disk  is 
in  DOS- 11  format,  use  the  FLX  Image  Mode  switch  (/IM)  to 
convert  the  file  (the  diagnostic  program)  to  Files-11  format. 
The  file  is  in  formatted  binary  format  and  has  a  file  type  of 
.BIC  or  .BIN.  (Note  that  binary  formatted  files  are  not 

patchable . ) 

2.  Reconfigure  your  system  so  that  you  have  a  system  with  two 
CPUs  and  two  memory  boxes,  and  each  box  has  256K  words  of 
memory.  The  configuration  would  be  as  follows: 


BOX  0 

PORT  A 

ONLINE,  START=000 

PORT  B 

OFFLINE 

BOX  1 

PORT  A 

OFFLINE 

PORT  B 

ONLINE,  START=000 

1 1ST 

Off  line 

both  sides. 

3.  Boot  RSX-1 1M-PLUS  on  CPA. 

4.  Set  BOX  0  PORT  A  to  ONLINE,  START=010 

5.  Bring  Box  1  on  line.  This  memory  box  will  contain  the 
diagnostic  partition.  For  example: 

CON>ONL  MKE , MK2 : 

6.  Use  the  CON  DISPLAY  command  to  find  out  the  base  address  and 
size  of  the  memory  box.  For  example: 

C0N>DISP  FULL  ATT  FOR  MK2 : 

The  base  address  of  the  partition  will  be  the  base  address  of 
the  diagnostic  program. 
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7.  Create  the  diagnostic  partition  in  the  memory  box  by  using 
the  command  SET  /PAR  and  specifying  type  DIAG.  This 
partition  will  be  devoted  to  diagnostic  functions  and  should 
begin  at  the  location  in  memory  that  the  diagnostic  processor 
will  see  as  location  0  or  the  bottom  of  memory.  For  example: 

> SET  /PAR=JIMK:  20000:  1777: DIAG 

This  command  creates  a  partition  named  JIMK  with  a  base 
address  of  2000000  and  consisting  of  1777(10)  32-word  blocks. 
The  other  processors  see  the  memory  box  used  for  diagnostics 
as  starting  at  location  2000000,  but  the  processor  running 
the  diagnostic  will  see  the  box  as  starting  at  location  0. 

Other  partition  types  used  with  the  SET  /PAR  command  ensure 
that  the  requested  memory  is  within  the  system  image  area 
(less  than  $SYSIZ) ,  but  DIAG  ensures  only  that  the  memory 
physically  exists.  For  the  other  processor  to  run 
concurrently  with  the  diagnostic  processor,  the  partition 
must  be  larger  than  $SYSIZ. 

8.  Use  DLD  to  convert  the  binary  formatted  file  into  a  bootable 

system  image  file  (patchable  with  ZAP;  see  the 

RSX-1 1 M/M- PLUS  Ut i 1 i tes  Manual)  and  then  to  load  it  into  the 
partition.  The  DLD  command  line  has  the  following  format: 

DLD> [part i t ion] [/HE] =f ilename [ . typ] [/qualifier] 

partition 

The  partition  created  in  the  diagnostic  processor's 
memory  box  into  which  the  diagnostic  program  will  be 
loaded.  You  must  specify  a  partition  name  if  you  do  not 
use  the  /NL  switch  (see  below) .  DLD  produces  a 
"partition  not  found"  error  message  otherwise.  If  you 
specify  both  a  partition  name  and  the  /NL  switch,  the 
switch  overrides  the  name. 

/HE 

Provides  a  brief  description  of  DLD's  use  and  format. 

typ 

The  file  type  for  the  diagnostic  program.  File  type  can 
be  .BIC,  .BIN,  or  .SYS. 

If  the  file  type  is  .BIC  or  .BIN,  DLD  converts  the  file 
into  a  system  image  file.  If  you  specify  either  file 
type,  but  DLD  cannot  find  the  file,  it  searches  for  the 
other  file  type  before  giving  up.  If  you  do  not  specify 
any  file  type,  DLD  first  looks  for  a  file  with  the  .BIC 
file  type  and  then  for  one  with  the  .BIN  file  type. 

If  the  file  type  is  .SYS,  DLD  does  not  have  to  convert 
the  file;  it  is  ready  to  be  loaded  into  the  memory  box. 

/qualifier 

One  of  the  following: 

/NL  Inhibits  loading  of  the  diagnostic  program 

(DLD  only  creates  the  system  image  file) . 
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/NC  Inhibits  clearing  (zeroing)  of  any  remaining 

memory  in  the  partition  after  the  diagnostic 
program  has  been  loaded.  The  default  is  to 
clear  the  remaining  memory. 

/OFF:n  Offsets  the  starting  location  of  the  load  by 
n  times  32(10)  words.  The  area  between  the 
beginning  of  the  partition  and  the  beginning 
of  the  diagnostic  is  untouched. 

/LI  Lists  information  about  the  partition  and 

the  file:  the  partition  name  (if  you  have 

specified  one) ,  the  base  and  size  of  the 
partition,  and  the  new  name  of  the  system 
image  file  (if  converted). 

Specifying  this  switch  gives  you  the 
transfer  address  (usually  200  or  1000)  of 
the  diagnostic  program.  The  transfer 
address  is  needed  to  initiate  the 
diagnostic . 

/LW  Accounts  for  the  DOS-11  link  word  that  may 

exist  in  bytes  0  and  1  of  every  input  block. 


Example 


DLD> JIMK=TEST. BIN/LI 
PARTITION  NAME:  JIMK 

PARTITION  BASE:  20000  SIZE:  1777  (32.  WORD  BLOCKS) 
FILE  NAME:  TEST. SYS; 1 
TRANSFER  ADDRESS:  200 

This  command  sequence  converts  the  binary  formatted 
diagnostic  file  TEST. BIN  into  the  system  image  file  TEST. SYS. 
DLD  also  lists  the  transfer  address  of  the  file  and  other 
information  about  the  file  and  the  partition. 

9.  DLD  loads  the  program  into  a  region  that  it  creates  in  the 

diagnostic  partition.  The  region  is  called  DIAG  and  is  the  same 
size  as  the  partition.  After  the  program  is  loaded,  DLD  clears 
any  remaining  memory  from  the  partition  (unless  otherwise 
specified) . 

10.  To  run  the  diagnostic  program,  halt  the  processor  (in  this  case, 

CPB) ,  toggle  in  the  transfer  address  of  the  program  (from  using 

the  /LI  switch) ,  and  then  push  the  START  button  to  begin  the 

diagnostics . 

11.  Use  the  MCR  command  line 

> REMOVE  DIAG/REG 

to  remove  the  diagnostic  partition  from  the  memory  box. 


15.9  ERROR  MESSAGES 


The  CON  and  HRC  error  messages  consist  of  one  or  more 
information  in  the  following  format: 


lines  of 


CON  —  error  message 
(detail  of  error  message) 
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The  first  line  is  the  general  error  message.  The  second  and  any 
succeeding  lines  define  the  error  message. 


In  addition  to  the  description,  the 
Directive  Status  Word  error  codes 
explanations  of  these  codes,  refer  to 
Reference  Manual. 


error  messages  may  include 
and  I/O  error  codes.  For 
the  IAS/RSX  I/O  Operations 


A  list  of  the  CON  and  HRC  error  messages  and  a  brief  explanation  of 
each  follows. 


15.9.1  CON  Error  Messages 

CON  —  Bad  indirect  command  file  specification 

Explanation:  The  name  of  an  indirect  command  file  (@filename)  is 

syntactically  incorrect . 

CON  —  Command  execution  error 

Explanation:  CON  cannot  process  the  specified  command 

line.  (More  specific  information  is  also  given.) 

CON  —  Command  intent  inconsistent  with  device  state 

Explanation:  An  attempt  was  made  to  place  on  line  a  device  that 

is  in  the  marked  for  off-line  state. 


CON  —  Command  list  is  empty.  Nothing  to  print 

Explanation:  The  CON  LIST  command  was  issued  when  CON's  internal 

buffer  was  empty. 

CON  —  Command  syntax  error  * 

Explanation:  The  command  line  does  not  conform  to  command  syntax 

rules. 


The  command  is  displayed  with 
last  recognized  keyword  or 
the  command  description  for 
command  line. 

CON  —  CONFIGURE  Version  nnn 

Explanation:  This  message  is 


a  question  mark  (?)  following  the 
parameter  typed  by  the  user.  Check 
correct  format  and  reenter  the 


returned  by  the  CON  IDENT  command. 


CON  —  CON  is  unable  to  do  an  extend  task  operation  to  obtain  pool  for 
a  read  of  the  system  configuration.  Please  ensure  that  a 
checkpoint  file  has  been  allocated  and  reissue  the  CON  command 

Explanation:  Self-explanatory. 


CON  —  File  open  er ror/FILE=f i lename/No  such  file 

Explanation:  An  invalid  file  specification  was  used  with  the 
LIST  command.  Check  the  device  name  and  UFD  and  reenter  the 
command  line. 

CON  —  HRC  has  timed  out  during  initialization 

Explanation:  This  message  could  indicate  an  error  in  the  I/O 
data  structure.  Please  verify  that  your  device  data  structures 
are  correct. 
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CON  —  HRC  version  nnn 

Explanation:  This  message  is  returned  by  the  CON  IDENT  command. 

CON  —  Illegal  command 

Explanation:  The  command  is  not  a  valid  CON  command  or  a  valid 

command  was  used  illegally. 

CON  —  Illegal  keyword 

Explanation:  The  keyword  is  not  valid  for  the  specified  CON 

command  or  a  valid  keyword  was  used  illegally. 

CON  —  Initialization  error 

Explanation:  CON  was  unable  to  properly  initialize  itself  or  its 

links  with  the  RD:  driver  and  the  HRC...  task.  Verify  that  the 
driver  is  loaded  and  that  HRC...  is  installed. 

CON  —  Initialization  request  of  HRC...  has  failed.  Please  ensure  that 
HRC...  is  installed. 

Explanation:  CON  is  unable  to  start  HRC  running. 

CON  —  Input  error  on  input  command  file 
FILE=f ilename 

Explanation:  The  file  you  have  specified  exists,  but  CON  could 

not  read  it. 

CON  —  Internal  consistency  error 

Explanation:  An  error  internal  to  either  CON  or  HRC  has 

occurred.  This  is  most  often  an  internal  addressing  trap  or  a 
malfunctioning  driver.  Submit  a  Software  Performance  Report 
(SPR)  if  the  problem  seems  to  be  with  DIGITAL-standard  software. 

CON  —  Internal  core  pool  exhausted 

Explanation:  CON  has  run  out  of  internal  pool  space  or  was 

invoked  without  checkpoint  space  first  being  allocated.  If  out 
of  pool  space,  check  the  /MAXEXT  setting.  (See  the  description 
of  the  SET  command  in  the  RSX-1 1M/M-PLUS  MCR  Operations  Manual.) 

CON  —  Maximum  indirect  command  file  depth  exceeded 

Explanation:  You  have  specified  that  CON  use  an  indirect  command 

file  that  exceeds  CON's  maximum  nesting  depth  of  three. 

CON  —  No  device  name  matches  select  string 

Explanation:  You  have  specified  with  the  DISPLAY  command  a 

logical  device  name  that  does  not  exist  in  the  system. 

CON  —  No  HRC  version  information  available 

Explanation:  This  message  is  returned  by  the  CON  IDENT  command 

if  HRC  is  not  installed. 

CON  —  No  reconfiguration  driver  is  available 
Output  to  HRC  is  suppressed 

Explanation:  The  reconfiguration  driver  (RD:)  is  not  loaded  in 

the  system. 
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CON  —  Open  error  on  input  command  file 
FILE=f ilename 

Explanation:  The  input  file  you  have  specified  does  not  exist. 

CON  —  Unable  to  assign  command  LUN 

Explanation:  CON  was  unable  to  assign  its  command  input  LUN  to 

TI:  . 

CON  —  Unknown  command  error 

Explanation:  For  undetermined  reasons,  CON  cannot  read  the 

command . 

CON  —  Unknown  device  or  invalid  device  specification 

Explanation:  The  device  specified  for  a  command  other  than  the 

DISPLAY  command  is  not  known  to  the  system.  Consult  the  system 
configuration  for  the  proper  name  of  the  target  device. 

CON  —  You  must  be  privileged  to  modify  the  system  configuration 

Explanation:  The  command  specified  in  the  command  line  must  be 

issued  from  a  privileged  terminal. 


15.9.2  HRC  Error  Messages 

The  following  messages  are  related  to  HRC  but  also  come  from  CON. 

Attempt  to  quiet  unit  for  controller  failed 

Explanation:  When  a  controller  with  units  on  line  is  taken  off 
line,  the  on-line  units  are  quieted  and  set  to  the  marked  for 
on-line  state.  HRC  attempts  to  access  the  unit  when  it  does  not 
have  context  and  can  be  taken  off  line.  HRC  makes  1000(10) 
attempts  to  quiet  the  device.  If  the  device  has  not  been 
successfully  accessed  after  the  1000  attempts,  CON  displays  this 
message . 

Attribute  format  error 

Explanation:  HRC  received  a  read  or  write  attributes  QIO  in 

which  the  desired  attributes  were  either  incorrectly  specified  or 
inappropriate  for  the  specified  device. 

CSR  for  controller  not  present  in  I/O  page 

Explanation:  An  attempt  was  made  to  bring  on  line  a  controller 

that  does  not  exist  in  the  current  hardware  configuration. 

Device  already  linked 

Explanation:  A  LINK  command  was  issued  for  a  bus  run  that  is 

already  linked  to  a  CPU. 

Device  not  linked 

Explanation:  An  UNLINK  command  was  issued  for  a  bus  run  that  is 

not  currently  linked  to  a  CPU. 
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Device  is  unknown  in  this  configuration 

Explanation:  HRC  has  received  a  request  to  bring  on  line  a 

device  that  is  unknown  because  it  had  been  previously  assigned  a 
CSR  address  of  160000  or  less. 

Executive  or  driver  status  change  error 

Explanation:  During  a  controller  on-line  or  off-line  operation, 

either  the  executive  controller  status  change  routines 
($ONKRB/$OFKRB)  or  the  driver's  controller  status  change  routine 
(xxKRB)  were  unable  to  change  the  state  of  the  controller. 

HRC...  can't  take  box  offline.  Not  last  box  in  memory 

Explanation:  An  attempt  was  made  to  take  off  line  a  memory  box 

that  is  not  at  the  end  of  the  current  physical  memory 
configuration. 

HRC...  can't  take  box  offline.  Partition  overmaps  box 

Explanation:  An  attempt  was  made  to  take  a  memory  box  off  line, 

but  the  memory  is  currently  in  use  for  a  partition.  The 
partition  must  either  be  removed  with  SET  /NOPAR  or  reduced  in 
size  with  SET  /TOP  (see  the  RSX-1 1M/M-PLUS  MCR  Operations 
Manual) . 

HRC...  detected  I/O  data  base  consistency  error 

Explanation:  During  the  course  of  taking  a  device  off  line,  HRC 
detected  an  error  in  the  structure  of  the  system  device  data 
base . 

HRC...  internal  addressing  error 

Explanation:  An  odd  address  trap  (or  other  software  trap)  has 

occurred  within  HRC.  This  may  be  due  to  a  bug  in  HRC  or  an 
inconsistency  in  the  system's  I/O  data  base. 

HRC...  internal  tables  insufficient  for  this  system 

Explanation:  HRC  creates  a  list  of  units  on  the  stack  when 

taking  a  controller  off  line.  This  message  is  produced  if  HRC 
encounters  a  controller  with  too  many  units  to  create  a  list. 

The  maximum  number  of  units  for  each  controller  is  defined  by  the 
symbol  .MXCTL  in  HRPRE  and  is  currently  set  to  256(10). 

HRC...  invalid  device  specification 

Explanation:  HRC  received  a  request  to  bring  memory  on  line,  but 

the  specified  device  was  not  a  memory  box. 

HRC...  request  format  error 

Explanation:  HRC  received  a  QIO  in  which  the  format  of  the 

parameters  was  incorrect.  If  the  issuing  task  for  the  request 

was  CON,  this  error  implies  a  software  fault. 

HRC...  unable  to  access  device  to  size  drive 

Explanation:  When  certain  types  of  device  units  are  brought  on 

line,  HRC  must  "size"  the  drive  (for  example,  to  determine  if  a 
DB:-type  device  is  an  RP05  or  an  RP06) .  This  message  is  issued 
if  the  sizing  process  fails  for  any  reason  (for  example,  the 
drive  is  not  powered  up  when  the  CON  ONL  command  is  issued) • 
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HRC . • .  unknown  error  from  online/offline  call 

Explanation:  HRC  received  from  the  driver  on-line/off-line  call 

an  unsuccessful  status  that  is  not  one  of  the  normally  expected 
return  codes. 

Invalid  device  descriptor 

Explanation:  HRC  received  a  request  to  take  a  port  off  liner  but 

the  port  description  was  invalid. 

Memory  box  parameter  error 

Explanation:  An  attempt  has  been  made  to  bring  on  line  a  set  of 

memory  boxes  whose  current  physical  configuration  does  not  allow 
the  specified  command  to  be  executed. 

Offline  controller  failure 

Explanation:  HRC  attempted  to  take  a  controller  off  line,  but 

the  controller  did  not  properly  change  state.  However,  no 
explicit  error  was  recognized. 

Offline  unit  failure 

Explanation:  HRC  attempted  to  take  a  unit  off  line,  but  the  unit 

did  not  properly  change  state.  However,  no  explicit  error  was 
recognized . 

Parameter  error 

Explanation:  HRC  received  a  request  to  link  a  bus  run,  but  the 

device  specified  was  not  a  bus  switch.  If  the  requesting  task 
was  CON,  this  probably  implies  a  software  fault. 

Syntax  error 

Explanation:  HRC  received  a  command  to  link  a  bus  run  to  a 

device  that  is  not  a  CPU. 

Timeout  on  unit  quieting  operation 

Explanation:  HRC  was  unsuccessful  in  attempting  to  "catch”  a 

unit  in  its  quiet  state  to  take  it  off  line  after  1000(10) 

attempts . 

Unable  to  access  bus  run 

Explanation:  HRC  was  unable  to  create  or  remove  the  vectors  for 

a  device  because  the  device's  bus  run  was  inaccessible.  Because 

HRC  checks  bus  run  status  and  uses  the  marked  for  on-line  state 
for  devices  on  off-line  bus  runs,  this  message  probably  implies  a 
software  fault. 

Unable  to  switch  unit  from  the  current  controller 

Explanation:  This  error  is  displayed  for  two  reasons: 

1.  HRC  attempted  to  take  off  line  the  controller  for  a  port 
to  which  the  bus  switch  is  currently  switched. 

2.  HRC  attempted  to  take  off  line  a  controller  (with  units) 
whose  access  path  cannot  be  changed. 
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Unable  to  take  unit  with  context  offline 

Explanation:  An  attempt  was  made  to  take  one  of  the  following 

units  off  line: 

•  A  mounted  Files-11  device 

•  An  attached  device 

•  A  logged-in  terminal 

•  A  bus  switch  whose  bus  run  is  currently  linked 

•  A  memory  box  unit  whose  memory  is  currently  on  line 


CHAPTER  16 


RSX-11M-PLUS  I/O  QUEUE  OPTIMIZATION 


I/O  Queue  Optimization  is  used  to  improve  the  throughput  of  the  disk 
subsystem  used  in  your  RSX-11M-PLUS  system.  Disk  throughput  is 
improved  by  making  the  most  effective  use  of  the  list  of  I/O  requests 
in  the  queue  for  a  particular  disk  device.  The  I/O  queue  for  the 
device  is  scanned  by  I/O  Queue  Optimization  and  after  each  request  is 
examined,  the  best  request  is  dequeued  and  passed  to  the  I/O  driver 
for  processing.  How  Queue  Optimization  determines  which  I/O  request 
is  best,  depends  on  which  method  of  I/O  Queue  Optimization  is  used. 
There  are  three  methods  of  I/O  Queue  Optimization  available  (you  can 
also  choose  not  to  have  I/O  Queue  Optimization) : 

Nearest  Cylinder 
Elevator 
Cylinder  Scan 

The  method  that  serves  you  best  depends  on  your  processing 
environment.  All  three  methods  attempt  to  minimize  head— seek  time, 
which  decreases  the  seek-time  component  of  the  file  service  time. 

Since  I/O  Queue  Optimization  works  by  optimizing  requests  in  the 
queue,  optimization  happens  only  when  I/O  requests  are  present  in  the 
queue.  If  the  system  loading  is  such  that  there  are  few,  if  any, 
requests  in  the  queue,  little  optimization  is  achieved. 

Without  I/O  Queue  Optimization,  the  operating  system  groups  the  I/O 
requests  in  the  queue,  by  priority,  on  a  first-in  first-out  basis. 
The  highest  priority  requests  appear  first  in  the  queue  and  are 
processed  in  sequence.  With  I/O  Queue  Optimization,  the  I/O  requests 
within  priority  groups  are  examined  and  the  request  having  the 
appropriate  disk  address  is  chosen  as  the  next  I/O  operation.  The 
highest  priority  requests  are  still  serviced  first.  However, 
throughput  is  increased  by  advantageous  reordering  of  requests  within 
priority. 

In  some  cases,  I/O  Queue  Optimization  may  provide  smoother  disk 
operation  by  reducing  erratic  head  movement. 


16.1  INITIATING  OPTIMIZATION 

The  MCR  SET  /OPT  command  is  used  to  initiate  I/O  Queue  Optimization. 
The  parameters  in  this  command  are  used  to  specify  the  disk  device, 
the  method  of  optimization,  and  a  fairness  count  limit  for  passed  over 
I/O  requests.  These  parameters  are  explained  in  detail  in  following 

paragraphs . 

The  SET  command  is  only  for  privileged  users.  Nonpr ivi leged  users  can 
use  this  command  only  to  display  the  optimization  status  of  devices  in 
the  system. 
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Format : 

SET  / [NO] OPT [=ddn : opt type : f a i rnesscount . ] 

Parameters 
ddn 

The  disk  device  requiring  optimization: 

DBn  RP04, RP05,RP06  Pack  Disks 

DRn  RM02,RM03,RM05,RM80, RP07  Pack  Disks 

DMn  RK06  and  RK07  Cartridge  Disks 

DLn  RL01  and  RL02  Cartridge  Disks 

opttype 

The  type  of 

NEARfEST] 

ELEV [ATOR] 

CSCAN 

The  default 
f airnesscount 

A  limit  on  the  number  of  times  the  most  unsatisfactory  I/O 
request  is  passed  over  (see  Section  16.2.1). 

The  default  is  10. 


optimization  needed: 

Initiates  Nearest  Cylinder  method;  next  request 
picked  is  the  closest  to  current  request. 

Initiates  Elevator  method;  requests  are  processed 
first  in  one  direction  along  the  disk  and  then  in 
the  reverse  direction. 

Initiates  Cylinder  Scan  method;  requests  are 
processed  in  only  one  direction  along  the  disk 
(lowest  to  highest) . 

is  NEAREST. 


16.1.1  Displaying  Optimization  Status 

You  can  display  the  optimization  status  for  all  devices  in  the  system 
that  are  currently  using  I/O  Queue  Optimization  by  entering: 

>SET  /OPT 

This  displays  status  in  the  form: 

OPT=ddn : opttype :fairnesscount 

For  example: 

OPT=DBO : NEAR : 10 . 

0PT=DB1: ELEV: 5. 

OPT=DB2 : CSCAN : 8 • 

You  can  also  display  which  devices  are  not  using  I/O  Queue 
Optimization  by  entering: 

>SET  /NOOPT 

This  displays  status  in  the  form: 

NOOPT=ddn : 
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For  example: 

NOOPT=DRl : 

Nonpr ivileged  as  well  as  privileged  users  can  display  status. 


16.2  SELECTING  THE  TYPE  OF  OPTIMIZATION 

Selecting  the  correct  optimization  method  is  dependent  upon  the  I/O 
processing  environment  in  which  your  application  is  running,  the 
physical  location  of  data  on  the  disk  drive,  and  how  often  tasks 
access  certain  data  areas. 

A  general  guideline  is  to  try  the  default  first.  (This  initiates  the 
Nearest  Cylinder  method  with  a  fairness  count  limit  of  10.)  Then 
compare  the  difference  in  throughput  by  timing  the  application  runtime 
against  a  suitable  clock.  For  a  closer  look  at  disk  activity  and 
throughput,  use  Resource  Accounting  (see  Chapter  17).  Resource 
Accounting  provides  this  data  under  the  heading  DEVICE  STATISTICS  in 
the  output  from  the  Resource  Accounting  transaction  file. 

The  default  (NEAREST  and  a  fairness  count  of  10)  is  an  average  setting 
and,  in  most  cases,  should  improve  I/O  throughput.  After  a  closer 
observation  and  as  you  become  more  familiar  with  the  I/O  load  and  data 
organization  on  the  disk  in  your  application,  you  can  make 
adjustments.  You  can  change  the  fairness  count  limit  or  use  one  of 
the  other  methods  of  I/O  Queue  Optimization. 


16.2.1  Adjusting  the  Fairness  Count  Limit 

When  using  I/O  Queue  Optimization,  you  should  watch  for  increased 
waiting  time.  I/O  requests  to  some  data  areas  may  have  slower  than 
normal  access  times,  because  Optimization  categorizes  them  as 
unsatisfactory.  When  this  happens.  Optimization  passes  over  these 
requests  for  a  better  choice,  keeping  the  unsatisfactory  requests  in 
the  queue  longer.  This  may  cause  a  decrease  in  performance  for  some 
tasks  even  though  overall  system  performance  has  improved. 

To  counteract  increased  waiting  time  and  acquire  a  better  balance,  you 
can  adjust  the  fairness  count  limit.  This  puts  a  limit  on  how  many 
times  an  I/O  request  can  be  passed  over.  Optimization  increments  the 
fairness  count  for  the  first  I/O  request  in  the  queue  whenever  that 
request  in  the  queue  is  passed  over.  When  the  fairness  count  for  an 
I/O  request  reaches  the  limit  indicated  with  the  SET  command,  the 
request  is  dequeued  and  the  fairness  count  is  cleared. 

Decreasing  the  fairness  count  limit  reduces  waiting  time  but  decreases 
the  overall  throughput  initially  gained  with  the  higher  count.  If  you 
find  you  must  decrease  the  fairness  count  limit,  try  another 
optimization  method.  It  may  be  more  applicable  to  your  situation. 


16.2.2  Nearest  Cylinder 

The  Nearest  Cylinder  method  processes  the  I/O  request  that  is  closest 
to  the  current  cylinder.  In  general,  this  method  is  effective  for 
both  long  and  short  I/O  queues.  There  may  be  an  increase  in  waiting 
time,  however,  and  this  may  be  unacceptable  in  an  interactive 
environment.  To  remedy  this,  reduce  the  fairness  count  limit,  which 
reduces  the  throughput,  or  try  one  of  the  other  optimization  methods. 
(Elevator  may  be  the  next  best  choice.) 
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16,2.3  Elevator 


The  Elevator  method  processes  I/O  requests  like  an 
processes  requests  as  it  moves  in  one  direction  along 
it  reaches  the  last  request  in  that  direction.  Elevator 
direction  and  processes  requests  in  that  direction. 


elevator.  It 
the  disk  until 
then  changes 
This  method  is 


effective  if  there  are  many  I/O  requests  outstanding.  Alsof  waiting 
time  tends  to  be  less  with  the  Elevator  method  than  with  the  Nearest 
Cylinder  method. 


The  Elevator  method  favors  the  center  of  the  disk.  Requests  are  done 
as  they  are  passed,  and  the  center  of  the  disk  tends  to  be  passed  over 
twice  as  often  as  the  periphery.  So  a  task  that  has  a  number  of 
requests  located  in  the  center  of  the  disk  tends  to  have  faster  I/O 
than  a  task  with  requests  at  the  periphery. 


16.2.4  Cylinder  Scan 

The  Cylinder  Scan  optimization  method  operates  like  the  Elevator 
method  except  the  Cylinder  Scan  method  processes  I/O  requests  only 
while  passing  in  one  direction  along  the  disk.  The  direction  is 
lowest  cylinder  number  to  highest  cylinder  number.  This  method  is 
most  effective  if  each  task  tends  to  do  I/O  to  a  localized  area  on  the 
disk.  It  results  in  a  more  even  distribution  of  I/O  among  tasks. 


16.3  ERROR  MESSAGES 
SET  —  Privileged  command 

Nonpr ivileged  users  can  only  display  status. 

SET  —  Feature  not  supported 

User  tried  to  initiate  Optimization  for  a  disk  device  that 
not  support  Optimization. 

SET  —  Device  not  in  system 

User  tried  to  initiate  Optimization  for  a  disk  device  that 
mounted  in  the  system. 

SET  —  Illegal  keyword  value 

User  specified  a  fairness  count  higher  than  128(10). 

SET  —  Invalid  keyword 

User  tried  to  use  an  invalid  keyword. 

SET  —  Device  offline  or  privileged  diagnostic 

User  tried  to  initiate  Optimization  for  an  off-line  device. 


does 


is  not 
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17.1  INTRODUCTION 

RSX-1 1M-PLUS  Resource  Accounting  is  a  system  generation  option  that 
provides  a  transaction  file  of  system  usage  information.  Accounting 
gathers  data  for  both  the  user  and  the  system.  The  data  allows  the 
billing  of  individual  users  for  the  resources  used,  as  well  as  the 
measuring  of  overall  system  usage. 

Some  of  the  system  usage  information  gathered  by  Resource  Accounting 
and  saved  in  the  transaction  file  is: 

User  Data 

•  Session  identification,  terminal,  and  account  number 

•  Billing  stop  date  and  time 

•  CPU  usage  time 

•  Tasks  active  at  time  of  logoff  or  crash 

•  Number  of  tasks  run 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logoff  or  crash 
Task  Data 

•  Session  identi f icat ion ,  terminal,  and  account  number 

•  Disk  overlay  loads 

•  Number  of  times  checkpointed 

•  Number  of  times  context  has  been  loaded 

•  Highest  running  priority 

•  Task  begin  time  and  end  time 

•  CPU  usage  time 

•  Number  of  directives  and  QIOs  issued 

•  Status  at  logoff  or  crash 
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System  Data 

•  Accounting  start  date  and  time 

•  Accounting  stop  date  and  time  (0  if  system  crashes) 

•  Shutdown  code 

•  Transaction  file  ID,  sequence  number,  and  device 

•  Last  scan  date,  time,  and  scan  rate  in  seconds 

•  Total  CPU  time  and  total  CPU  zero  intervals 

•  Total  number  of  tasks  executed 

•  Total  number  of  logons 

•  Number  of  current  users 

•  Number  of  checkpoints 

•  Number  of  Shuffler  runs 

•  Number  of  directives  issued 

•  Number  of  QIOs  issued 
Logon  Data  or  Invalid  Logon  Data 


• 

User  name,  ID,  terminal,  and  account  number 

• 

Logon  UIC,  date,  and  time 

• 

Illegal  password 

Device 

Allocation,  Deallocation  Data,  or  Dismount  Data 

• 

Session  ID,  terminal,  and  account  number 

• 

Allocation  or  deallocation  date,  time,  and  device 

Device 

Mount 

• 

Session  ID,  terminal,  and  account  number 

• 

Mount  date,  time,  and  device 

• 

Volume  label  for  Files-11  mounted  device 

• 

Type  of  mount  (foreign,  shared,  and  so  on) 

• 

• 

Owner  UIC 

Volume  protection  code 

• 

Name  of  ACP  for  device 

Print  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Print  job  date  and  time 
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•  Job  name  and  page  count 

•  Number  of  files  printedf  printer  device,  and  forms  number 

•  Job  priority 
Card  Reader  Job  Data 

•  Session  ID,  terminal,  and  account  number 

•  Batch  or  print  job  name 

•  Number  of  cards  read 

•  Reader  device  name  and  number 
System  Time  Change 

•  Old  Time 

•  New  Time 
Device  Usage  Data 

•  I/O  counts 

•  Error  counts 

•  Tuning  information 

There  are  several  ways  to  access  the  system  usage  information 
contained  in  the  transaction  file.  They  are: 

•  The  SHOW  ACCOUNTING  commands  (see  Section  17.3): 

-  SHOW  ACCOUNTING/INFORMATION  displays  system  usage 
information  about  specific  terminals 

-  SHOW  ACCOUNT ING/TRANSACTION_F I LE  generates  a  formatted 
version  of  the  transaction  file 

•  A  report  program  written  by  DATATRIEVE-11  (see  Section  17.4) 

•  User-written  analysis  programs  (see  Section  17.5) 

Resource  Accounting  gathers  system  usage  information  by  collecting  the 
data  in  account  blocks  in  secondary  pool  and  writing  each  account 
block  as  a  record  in  the  transaction  file.  These  account  blocks  are: 

•  Task  Account  Block  (TAB) 

•  User  Account  Block  (UAB) 

•  System  Account  Block  (SAB) 

•  Transaction  account  blocks 

For  a  description  of  account  blocks,  their  structure,  and  how  Resource 
Accounting  uses  them,  see  Section  17.6. 
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The  following  sections  describe  the  Resource  Accounting  commands. 
Parameters  are  separated  by  spaces,  you  may  abbreviate,  and  you  are 
prompted  for  missing  parameters.  All  commands,  except  SHOW 
ACCOUNTING/INFORMATION,  are  privileged.  (Slashes  in  SET  and  SHOW 
commands  are  optional.) 

The  Resource  Accounting  commands  are: 


START/ACCOUNTING 

Starts  up 

subsystem 

the 

Accounting 

STOP/ACCOUNTING 

Shuts  down 

subsystem 

the 

Accounting 

SET  ACCOUNTING 

Changes  parameters  in  a  started 
Accounting  subsystem 

SHOW  ACCOUNTING/INFORMATION 

Displays  Accounting 

information 

about  a  specific  terminal 


SHOW  ACCOUNT ING/TRANSACTION_F I LE  Converts  the  transaction  file 

to  a  readable  format  so  it  can 
be  displayed  on  a  terminal  or 
put  in  a  file 

SHOW  ACCOUNTING/DATATRIEVE  Converts  a  transaction  file  to 

a  file  that  is  readable  by 
DATATRIEVE-11 . 


17-4 


RSX-11M-PLUS  RESOURCE  ACCOUNTING 


START/ACCOUNTING 


17.2  CONTROL  COMMANDS 

17.2.1  START/ACCOUNTING  Command 

The  START/ACCOUNTING  command  starts  up  the  Accounting  subsystem.  The 
SYSLOG  and  ...ACC  tasks  must  be  installed  before  you  issue  the 
START/ACCOUNTING  command.  If  you  do  not  supply  the  optional 
parameters,  they  assume  defaults. 

Format 

START/ACCOUNTING  [parameterl] [parametern] 

Parameter 
FILE : f ilespec 

This  filespec  is  the  name  of  the  transaction  file  that  Accounting 
creates  to  store  the  data.  You  can  name  the  file  with  this 
parameter  or  accept  the  default,  LB : [ 1 , 6] ACNTRN. SYS . 


EXTEND_SIZ  E  rvalue 

This  value  is  the  size  of  the  initial  allocation  for  the 
transaction  file  and  for  each  extension  when  it  is  needed.  The 
value  can  be  any  reasonable  amount.  If  there  is  low  Accounting 
activity,  a  small  extension  size  is  adequate  because  few 
extensions  are  required  and  overhead  is  low.  If  Accounting 
activity  is  high,  a  larger  extension  size  lowers  the  overhead  if 
disk  space  is  available  for  the  larger  extension. 

The  default  value  is  10(10)  blocks. 


POOL_RE SERVE : dec imal  value 

This  value  is  the  number  of  blocks  of  secondary  pool  that 
Accounting  must  leave  free  after  each  allocation.  If  Accounting 
cannot  leave  this  amount  free,  the  allocation  will  fail  and 
prevent  the  swamping  of  secondary  pool. 

The  default  is  a  quarter  of  the  total  secondary  pool  size.  Use 
of  the  default  is  recommended. 


SYSTEM_STATISTICS: yes/no 

This  parameter  specifies  to  Accounting  whether  or  not  to 
accumulate  system-wide  statistics.  System-wide  statistics  are 
the  contents  of  the  accumulation  fields  in  the  System  Account 
Block.  These  fields  are: 

B • CPU  Total  CPU  time  used 

B.DIR  Total  directive  count 
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B.QIO  Total  QIO$  count 
B.TAS  Total  task  count 
The  default  is  yes. 


STATISTICS_SCAN[ rvalue] 

This  value  specifies  a  scan  rate  for  the  collection  of  device 
statistics.  These  device  statistics  are  mainly  used  to  measure 
seek-optimization  parameters.  They  also  provide  excellent 
information  on  disk  activity  and  throughput.  The  device 
statistics  are  collected  either  once  or  periodically.  To 
indicate  a  one-time  only  collection,  no  value  is  specified.  To 
collect  statistics  periodically,  the  value  specifies  the  rate  in 
minutes  (nM)  or  seconds  (nS) .  The  default  value  is  one  hour  if 
SYSTEM_S TATI STIC S : YES  is  specified. 

If  STATISTICS  SCAN  is  specified,  SYSTEM_STATISTICS  must  be 
specified.  Tfiis  restriction  does  not  apply  to  a  one-time  only 
request.  If  a  value  of  0  is  specified  or  SYSTEM_STATISTICS : NO  is 
specified,  this  feature  is  turned  off.  The  example  below  shows 
the  type  of  statistics  collected  in  a  transaction  file. 


SCAN_RATE : dec imal  value 

This  value  is  the  time  interval  between  the  periods  when 
Accounting  writes  the  SAB  and  active  UABs  to  the  scan  file  called 
LB: [ 1 , 6] SYSSCAN. TMP  for  protection  against  loss  in  event  of  a 
system  crash.  The  value  can  be  supplied  as  "nM"  or  "n"  for  n 
minutes,  or  "nS"  for  seconds.  If  you  specify  0,  no  scanning  is 
done;  therefore,  if  the  system  crashes,  the  active  UABs  and  the 
SAB  are  not  recorded  in  the  transaction  file  and  the  data  is 
lost. 

The  default  value  is  five  minutes. 

If  Accounting  finds  a  scan  file  when  you  start,  it  outputs  a 
crash  transaction  and  copies  the  data  in  the  scan  file  to  the  new 
transaction  file.  A  copy  of  this  crash  transaction  followed  by 
the  transaction  file  is  shown  as  the  output  of  the  SHOW 
ACCOUNT ING/TRANSACTION_F I LE  command  in  Section  17.3.2. 

Accounting  copies  all  the  old  data  before  it  writes  the  startup 
transaction  and  before  it  processes  any  new  data. 

When  you  stop  Accounting,  the  scan  file  is  deleted. 


CRASH_REASON: yes/no 

If  you  enter  "yes”  and  Accounting  is  started  after  a  crash  that 
occurred  when  scanning  was  active.  Accounting  prompts  you  to 
enter  a  reason  for  the  crash.  The  reason  can  be  as  many  as  60 
characters  in  length  and  is  stored  in  the  Crash  Recovery 
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Transaction  Block.  Accounting  prompts  for  "reason  for  crash" 
when  Accounting  is  restarted.  If  the  system  did  not  crash,  no 
prompt  occurs. 

If  you  enter  "no",  a  prompt  never  occurs;  the  default  is  no. 


TASK:yes/no 

If  you  enter  "yes,"  task  accounting  is  initiated.  Task 
accounting  gathers  data  on  individual  tasks  running  in  the 
system.  You  can  run  task  accounting  when  the  system  is  running 
at  peak  load  times  and  the  task  accounting  data  can  be  analyzed 
on  a  per  task  basis  to  identify  heavy  resource  users. 

If  you  enter  "no,"  task  accounting  is  stopped.  The  default  is 
no . 

Task  accounting  should  only  be  specified  when  you  absolutely  need 
task  accounting  data.  The  reason  is  that  task  accounting 
requires  substantial  disk  space  because  the  transaction  file  can 
become  quite  large. 
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Example 

The  type  of  device  statistics  collected  by  Resource  Accounting  is 
shown  in  the  following  output  from  a  transaction  file: 

DEVICE  STATISTICS 

TIME  OF  DEVICE  STATISTICS  =  15-DEC-81  16J27J23  DEVICE  =  DR1  l 
10  COUNT  =  0.  WORDS  TRANSFERRED  COUNT  =  0. 

SOFT  ERROR  LIMIT  =  8*  SOFT  ERROR  COUNT  =  0* 

HARD  ERROR  LIMIT  =  5*  HARD  ERROR  COUNT  =  0* 

CYLINDER  CROSSED  COUNT  =  0*  CURRENT  FAIRNESS  COUNT  =  0* 

FAIRNESS  COUNT  LIMIT  =  10* 


DEVICE  STATISTICS 

TIME  OF  DEVICE  STATISTICS  =  15-DEC-81  16J27J23  DEVICE  =  DR2J 
10  COUNT  =  13832*  WORDS  TRANSFERRED  COUNT  =  9002804* 

SOFT  ERROR  LIMIT  =  8*  SOFT  ERROR  COUNT  =  0* 

HARD  ERROR  LIMIT  =  5*  HARD  ERROR  COUNT  =  0* 

CYLINDER  CROSSED  COUNT  =  1053  CURRENT  FAIRNESS  COUNT  =  0* 

FAIRNESS  COUNT  LIMIT  =  10* 


DEVICE  STATISTICS 


TIME  OF  DEVICE  STATISTICS 
10  COUNT  =  68490* 

SOFT  ERROR  LIMIT  =  8* 

HARD  ERROR  LIMIT  =  5* 
CYLINDER  CROSSED  COUNT  = 
FAIRNESS  COUNT  LIMIT  =  10 


=  15 --DEC--81  1 6  J  27  t  24  DEVICE  *  DR 3 
WORDS  TRANSFERRED  COUNT  =  80640306* 
SOFT  ERROR  COUNT  =  0* 

HARD  ERROR  COUNT  =  0* 

313*  CURRENT  FAIRNESS  COUNT  =  7* 


Some  definitions  are: 

10  COUNT  is  the  number  of  I/O  requests. 

WORDS  TRANSFERRED  COUNT  is  the  number  of  words  transferred. 
SOFT  ERROR  is  a  recovered  error. 

HARD  ERROR  is  a  nonrecovered  error.  (See  the  RSX-11M/M-PLUS 
Error  Logging  Reference  Manual  for  more  information  about 
hard  and  soft  errors . ) 

CYLINDER  CROSSED  COUNT  is  how  many  cylinders  were  crossed 
while  accessing  data.  This  data  can  be  analyzed  for  I/O 
Queue  Optimization  purposes. 

FAIRNESS  COUNT  is  a  Queue  Optimization  parameter  that 
indicates  how  many  times  an  I/O  request  was  passed  over  (see 
Chapter  16) . 
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17.2.2  SET  ACCOUNTING  Command 

This  command  allows  you  to  change  the  value  of  parameters  specified 
when  Resource  Accounting  was  started  with  the  START/ACCOUNTING  command 
or  previously  modified  with  a  SET  command.  (A  transaction  is  written 
containing  the  old  value  and  the  new.) 

The  following  options  can  be  changed  while  Resource  Accounting  is 
running . 

•  The  file  transactions  are  written  to 

•  The  size  of  the  extensions 

•  The  scan  rate  for  the  scan  file 

•  The  scan  rate  for  collecting  device  statistics 

•  The  state  of  task  accounting  (on  or  off) 

Format 


SET  ACCOUNTING/[parameterl] [parametern] 

Parameter 
FILE [ : f ilespec] 

Changes  the  file  transactions  are  written  to.  Defaults  to  the 
current  filespec,  if  not  specified. 

EXTEND_SIZ  E  rvalue 

This  value  changes  the  size  of  the  transaction  file  specified  in 
the  START/ACCOUNTING  EXTEND_SIZE  parameter. 

STATISTICS_SCAN rvalue 

This  value  changes  the  scan  rate  for  collecting  device 
statistics.  A  value  of  0  stops  this  option. 

SCAN_RATE rvalue 

This  value  changes  the  scan  rate  for  the  scan  file  specified  in 
the  SCAN_RATE  parameter.  A  value  of  0  stops  this  option. 
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TASK:yes/no 

If  you  enter  "yes/1  task  accounting  is  started. 

When  specified ,  task  accounting  creates  task  account  blocks  for 
all  active  tasks  in  the  system.  All  data,  for  each  task,  is 
gathered  starting  at  this  time. 

If  you  enter  Hno,"  task  accounting  is  stopped. 

When  specified ,  task  accounting  on  a  per  task  basis  is  terminated 
and  the  data  for  all  active  tasks  is  written  to  the  transaction 
file.  The  only  exception  is  tasks  that  have  a  CPU  time  limit 
specified ,  since  the  data  is  necessary  for  the  time  limit  to  be 
checked.  The  data  for  these  tasks  is  written  to  the  transaction 
file  when  the  task  exits. 
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17.2.3  STOP/ACCOUNTING  Command 

This  command  shuts  down  the  Resource  Accounting  subsystem.  The 
parameter  is  provided  to  indicate  why  the  shutdown  is  occurring  and 
must  be  entered  with  the  command.  Accounting  puts  the  reason  for 
stopping  into  the  System  Account  Block. 

Formats 

STOP/ACCOUNTING  reason 
STOP/ACCOUNTING  CLEAN_UP 
Reason 
MAINTENANCE 

You  can  use  this  reason  when  you  stop  Accounting  for  system 
maintenance. 


REBOOT 

You  can  use  this  reason  if  you  must  reboot  the  system. 


SCHEDULED_SHUTDOWN 

You  can  use  this  reason  when  the  system  is  being  shut  down  or 
used  for  other  purposes  where  Accounting  is  not  applicable. 

SHUTUP 

The  SHUTUP  program  uses  this  reason  as  a  default  because  it  has 
no  means  of  determining  a  shutdown  reason. 


OTHER 


You  can  use  this  reason  when  any  of  the  above  reasons  are  not 
adequate . 


The  STOP/ACCOUNTING  CLEAN_UP  command  has  a  special  use.  It  must  be 
used  if  the  SYSLOG  task  aborts  or  Accounting  encounters  a  fatal  error. 
This  command  cleans  up  all  the  data  structures  to  allow  Accounting  to 
restart  successfully.  Accounting  accepts  this  command  only  if  it  is 
necessary  (after  an  Accounting  failure  or  abort) . 

When  you  use  this  command,  the  system  assumes  all  Accounting  data  in 
memory  to  be  invalid  and  deallocates  the  data  back  to  secondary  pool 
without  writing  it  to  the  transaction  file.  Note  that  if  the 
Accounting  data  structures  are  corrupted,  the  system  may  crash  while 
it  attempts  to  deallocate  secondary  pool. 

You  can  restart  Accounting  normally  after  you  issue  this  command. 
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17.3  SHOW  COMMANDS 

17.3.1  SHOW  ACCOUNTING/INFORMATION  Command 

ich  the  command  was 
specified  terminal. 
Accounting  data.  A 

Format 

SHOW  ACCOUNTING/INFORMATION [parameter] 


This  command  displays  on  the  terminal  from  wh 
issued  the  Accounting  information  for  the 
Nonpr ivileged  users  can  receive  only  their 
privileged  user  can  obtain  any  Accounting  data. 


Parameter 


TTn  : 


If  you  specify  TTn:,  this  command  displays  the  Accounting  data 
for  the  specified  terminal.  A  privileged  user  has  access  to  the 
Accounting  data  of  any  terminal  on  the  system. 


A  nonpr ivileged 


user  can  only  get  his  own  data.  The  default  terminal  is  TI:. 


If  you  enter  no  terminal  name,  the  Accounting  data  of  the 
terminal  issuing  the  command  is  displayed. 


CO: 


If  you  specify  C0:f  the  Accounting  data  of  the  system  tasks 
running  is  displayed  on  the  terminal. 


SYS 

If  you  specify  SYS,  the  current  system  totals  are  displayed  on 
the  terminal. 


TASK=taskname 


Shows  Accounting  data  for  the  specified  task  if  the  system  is 
maintaining  task  accounting. 
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17.3.2  SHOW  ACCOUNTING/TRANSACTION_FILE  Command 

The  SHOW  ACCOUNT ING/TRANSACTION_F I LE  command  converts  the  transaction 
file  into  a  readable  format.  It  either  displays  this  file  on  a 
terminal  or  writes  it  into  another  file.  The  SHOW  ACCOUNTING/- 
TRAN SACTI ON_F I LE  command  uses  the  current  transaction  file  as  the 
default  file.  (When  Accounting  is  not  running,  there  is  no  default 
file.) 

Format 

SHOW  ACCOUNTING/TRANSACTION_FILE [ : inputf ilespec]  outputf ilespec 
Parameter 
inputf ilespec 

The  input  file  is  the  transaction  file  to  be  read.  If  you  do  not 
specify  an  input  file,  the  current  transaction  file  is  used. 


outputf ilespec 

The  output  file  can  be  either  a  terminal  (specified  as  TTn :  or 

TI:)  or  a  file  of  your  choice. 


Notes 


UIC  [126,10]  on  the  distribution  kit  includes  the  source  code  for 
the  SHOW  ACCOUNT ING/TRANSACTION_F I LE  command  to  serve  as  an 
example  for  how  to  read  the  file.  Note  that  the  record  size  in 
the  file  is  equal  to  the  transaction  length.  The  only  exception 
to  this  is  the  Accounting  startup  transaction  that  only  occurs 
once  and  is  512(10)  bytes  long.  The  startup  transaction  consists 
of  a  header  only,  but  its  size  is  increased  to  512(10)  bytes  to 
force  a  file  extension.  See  Section  17.6  or  [126,10]  ACNDF.DOC 
on  the  distribution  kit  for  the  format  of  this  file. 

Example 

The  output  of  the  SHOW  ACCOUNTING/TRANSACT I ON_F I LE  command  is  a 
formatted  display  of  the  transaction  file.  The  default  file  is 
the  transaction  file  named  in  the  START/ACCOUNTING  command.  This 
example  of  output  of  a  SHOW  ACCOUNTING/TRANSACTION_FILE  command 
is  keyed  to  the  following  explanatory  comments: 


ACCOUNTING  DATA  -  CURRENT  FII.E  il-DEC-81  16:56104 


SYSTEM  CRASH  RECORD 

TIME  OF  LAST  SCAN  =  7-DEC-81  10M8J17  SCAN  RATE  (SEC)  =  300.  © 

RESTART  TIME  =  7-DEC-81  19:58115 
REASON  =  © 
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USER 


-  ALPHA  P  © 

SESSION  ID  =  F 1 1 43  TIS  =  TT40I  ACCOUNT  =  1* 


LOGON  UIC  =  C  7  >  1 1 1  3  LOGGED  ON 

LOGGED  OFF  =  00-000-00  OOJOOJOO 
CPU  =  4461*  TASKS  ACTIVE  = 

OIOS  ■  6215. 


=  7- DEC-81  08  J  58  J  53 

BILLING  STOPPED  =  7-DEC-81  10M8J17 
1.  TASKS  RUN  =  95. 

DIRECTIVES  =  10240. 


STATUS  ACT  CRH 


USER  -  SYSTEM  TASKS 

SESSION  ID  =  $SYO  TIJ  =  COJ  ACCOUNT  =  0. 

LOGON  UIC  =  C  0 , 0  3  LOGGED  ON  =  6-DEC-81  15M8J16 

LOGGED  OFF  =  00-00-00  OOJOOJOO  BILLING  STOPPED  =  7-DEC-81  10J48J17 

CPU  =  103866.  TASKS  ACTIVE  =  9.  TASKS  RUN  =  601. 

OIOS  =  128967.  DIRECTIVES  =  667250. 

STATUS  ACT  CRH 


TOTAL  SYSTEM  STATISTICS  © 

ACCOUNTING  STARTED  =  6-DEC-81  15I48J16 
ACCOUNTING  STOPPED  =  00-000-00  OOJOOJOO 
TRANS  FILE  ID  =  1422  SEQ  NUM  =  1 


TIME  OF  LAST  SCAN  = 
TOTAL  CPU  =  441264. 
TOTAL  TASKS  =  3236. 
CURRENT  USERS  =  27. 
SHF  RUNS  =  0. 


7- DEC-81  10J48:i7 


SHUTDOWN  CODE  =  0 
DEVICE  =  DBi: 
SCAN  RATE  (SEC)  =  300. 


ZERO  CPU  INTERVALS  =  374665. 

TOTAL  LOGONS  =  60. 

CHECKPOINTS  =  23. 

DIRECTIVES  =  2373564.  OIOS  =  556015. 


ACCOUNTING  STARTUP 

ACCOUNTING  STARTED  =  7-DEC-81  19J58J16 


LOGIN  -  BETA  B 

SESSION  ID  =  RXP1 
LOGON  UIC  =  C  7 , 102  3 

LOGIN  -  ALPHA  P 

SESSION  ID  =  F 1 1 2 
LOGON  UIC  =  C  7  r 1 1 1  3 


Ti:  =  TT26J  ACCOUNT  =  0. 
TIME  =  7- DEC-81  19:58J35 


T I :  =  TT55  i  ACCOUNT  =  1. 
TIME  =  7-DEC-81  20J05M4 


DEVICE  MOUNT 

SESSION  ID  =  F 1 1 2 

TIME  =  7- DEC-81  20:06J37 

OWNER  UIC  =  CO, 03 


T I J  =  TT55J  ACCOUNT  =  1. 

DEVICE  =  DR  1 t  VOL  ID  =  WELCOMEBACK 

ACP  NAME  =  F 1 1 A C P  VOL  PROT  MASK  =  0 


USER 


-  ALPHA 
SESSION  ID  = 
LOGON  UIC  = 
LOGGED  OFF  = 
CPU  =  141. 
DIRECTIVES  = 


P 

F 1 1 2  Ti:  =  TT55:  ACCOUNT  =  1. 

C7,1U3  LOGGED  ON  =  7-DEC-81  20t05i44 

7-DEC-81  20:06M3  BILLING  STOPPED  =  7-DEC-81 

TASKS  ACTIVE  =  0.  TASKS  RUN  =  17. 

472.  Q I  OS  =  166. 


20 ♦ 06  J  43 
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LOGIN  -  OMEGA  I' 

SESSION  ID  =  RXP3  Tit 

LOGON  UIC  =  1 7  »  7 1  3  TIME 


DEVICE  ALLOCATION 

SESSION  ID  =  RXP4  Tit 

TIME  =  7-DEC-81  20109:12 


=  TT37 1  ACCOUNT 
=  7-DEC-81  20 : 08 ! 


=  TT37 1  ACCOUNT 
DEVICE  =  DLO  1 


11 


4. 


4  . 


LOGIN  -  THETA  D 

SESSION  ID  =  SPR5  Tit 

LOGON  UIC  =  C 7 i 3271  TIME 


DEVICE  MOUNT 

SESSION  ID  =  RXP4  Tit 

TIME  =  7-DEC-8 1  20!0?:i5 
OWNER  UIC  =  C  7  » 1 07  3  ACP 


DEVICE  DEALLOCATION 

SESSION  ID  =  RXP4  Tit 


TIME  =  7- DEC-81  20109:15 


=  TT55 1  ACCOUNT  =  0. 
=  7- DEC-81  20!09tl4 


=  TT37 1  ACCOUNT  =  4. 

DEVICE  =  DLO  t  VOL  ID  = 

NAME  =  TSTACP  VOL  PROT  MASK 


=  TT37 1  ACCOUNT  =  4. 
DEVICE  =  DLO  t 


0 


o 

© 


USER  -  SYSTEM  TASKS 

SESSION  ID  =  tSYO 
LOGON  UIC  =  CO  f  03 


Tit  =  COi 


ACCOUNT  =  0, 


LOGGED  ON  =  7-DEC-81  19t58tl6 


LOGGED  OFF  =  00-000-00  OOtOOtOO 
CPU  =  1603.  TASKS  ACTIVE  = 

DIRECTIVES  =  2986. 


BILLING  STOPPED  =  7-DEC-81  20tl3t21 
TASKS  RUN  =  64. 


TOTAL  SYSTEM  STATISTICS 

ACCOUNTING  STARTED  =  7-DEC-81  19!58tl6 
ACCOUNTING  STOPPED  =  7-DEC-81  201 1 3  t  2 1 
TRANS  FILE  ID  =  205  SEQ  NUM  =  20 

STATISTICAL  SCAN  RATE  (SEC.)  =  3600. 
TIME  OF  LAST  SCAN  =  7-DEC-81  20!13tl7 
TOTAL  CPU  =  4260. 

TOTAL  TASKS  =  243. 

CURRENT  USERS  =  1. 

SHF  RUNS  =  0. 


SHUTDOWN  CODE  =  4 
DEVICE  =  DROt 
FILE  EXT.  SIZE  =  10. 
SCAN  RATE  (SEC)  =  300. 
ZERO  CPU  INTERVALS  =  3063. 

TOTAL  LOGONS  =  7. 

CHECKPOINTS  =  0. 

DIRECTIVES  =  10241.  OIOS  =  4946. 


The  crash  reason  appears  here  if  Accounting  prompts  you  for  a 
reason  for  the  crash.  The  prompt  occurs  only  if  you  answered  yes 
to  the  CRASH  REASON  parameter  in  the  START/ACCOUNTING  command. 

To  minimize  loss  of  data.  Accounting  writes  the  SABs  and 
currently  active  UABs  to  a  temporary  file  every  n  seconds  or 
minutes  unless  you  specify  a  zero  scan  rate  in  the 
START/ACCOUNTING  command.  The  process  of  writing  this  file  is 
called  a  scan.  When  you  restart  Accounting,  it  copies  any 
existing  temporary  file  of  Accounting  data  into  the  Accounting 
file  now  starting.  If  the  scan  rate  is  zero,  the  SABs  are 
memory-resident  until  you  stop  Accounting  or  the  system  crashes. 
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Also,  the  currently  active  UABs  are  memory-resident  until  a  user 
logs  off.  Therefore,  if  a  crash  occurs  with  the  scan  rate  at 
zero,  all  the  SAB  and  current  UAB  data  is  lost. 


©  The  User  Account  Block  (P.  Alpha)  shows  a  logged  off  date  and 
time  of  zero  because  the  system  crashed.  There  may  or  may  not  be 
a  "status"  line  as  the  last  line  of  the  User  Account  Block.  The 
status  line  indicates  the  bit  setting  of  the  status  mask  byte 
(B.STM)  in  the  UAB.  Three  of  the  bits  have  external  importance 
and  cause  this  line  to  appear  if  they  are  on.  These  bits  are: 


ACT  (BS.ACT) 


LGO  (BS.LGO) 


CRH  (BS.CRH) 


Indicates  that  the  UAB  was  written  to  the 
file  while  still  active  (all  activity  had  not 
ceased) .  This  can  happen  when  UABs  are 
copied  from  the  scan  file,  or  when  all  the 
data  structures  are  written  out  because 
Accounting  has  stopped. 

Indicates  that  the  user  has  logged  off  with 
tasks  remaining  active  or  with  clock  queue 
requests  pending. 

Indicates  that  this  UAB  came  from  the  scan 
file  and  was  copied  into  the  transaction  file 
when  Accounting  was  started  after  a  system 
crash . 


O  The  TOTAL  SYSTEM  STATISTICS  block  contains  the  shutdown  code  as  a 
digit  in  the  range  0  through  5.  These  digits  have  the  following 
^  meanings: 


0 

1 

2 

3 

4 

5 


Accounting  not  stopped  due  to  crash 

Maintenance 

Reboot 

Scheduled  shutdown 

Shutup 

Other 


The  ZERO  CPU  INTERVALS  field  shows  the  possible  error  in  the  CPU 
time  measurements.  The  error  occurs  because  the  system  clock  is 
usually  run  at  60  Hz  and  is  slower  than  the  context  switch  time 
of  the  Executive.  Therefore,  a  task  can  sometimes  execute  for 
zero"  ticks,  because  the  time  needed  for  its  execution  is  less 
than  the  resolution  of  the  clock.  Resource  Accounting  rounds 
each  zero  tick  to  one-half  tick  of  CPU  time  and  counts  them.  The 
ZERO  CPU  INTERVALS  field  contains  the  count  of  the  number  of  zero 
ticks  that  have  occurred. 
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17.4  WRITING  AN  ACCOUNTING  REPORT  PROGRAM  USING  DATATRIEVE-11 

The  data  collected  in  the  transaction  file  pertains  to  your  computing 
environment.  How  you  interpret  and  analyze  this  data  depends  on  your 
objectives.  For  instance,  are  you  interested  in  billing  or  system 

measurement?  To  obtain  the  Accounting  data  you  are  looking  for,  in 

the  form  you  want,  you  will  most  likely  write  your  own  report  program. 
This  program  accesses  the  transaction  file,  reads  the  required  data 
fields,  and  writes  a  report  containing  the  Resource  Accounting  data 
you  are  interested  in. 

One  way  to  write  this  specialized  report  is  to  use  DATATRIEVE-11.  But 
before  a  DATATRIEVE-11  program  can  access  the  transaction  file,  the 
file  must  be  converted  to  a  DATATRIEVE-11  readable  file.  To  convert 
the  file,  use  the  Resource  Accounting  SHOW  ACCOUNTING/DATATRIEVE 
command  (see  Section  17.4.1).  The  format  of  the  converted  file  is 

shown  in  LB : [126 , 24] ACNTRN. CMD  along  with  an  example  of  a  simple 

report  generator  written  in  DATATRIEVE-11. 

To  obtain  a  report  using  the  example  report  generator,  you  must: 

1.  Use  the  SHOW  ACCOUNTING  command  (see  Section  17.4.1)  to 
convert  the  appropriate  transaction  file  to  a  file  that  is 
readable  by  DATATRIEVE-11.  Name  the  file  ACCOUNT • DAT  (this 
is  the  name  used  in  ACNTRN. CMD,  for  example  purposes  only). 

2.  Copy  the  following  files  from  the  system  disk  to  your 
directory: 

[1,2] QUERY. DIC 

[126,24] ACNTRN.CMD 

After  the  above  files  are  made  available,  use  the  following  command 
line  to  generate  a  report: 

>DTR  0ACNTRN.CMD 

This  command  line  calls  DATATRIEVE-11  and  executes  the  DATATRIEVE-11 
commands  in  the  ACNTRN.CMD  file.  A  brief  description  is  then 
displayed  on  your  terminal  screen  with  a  portion  of  the  DATATRIEVE-11 
commands  that  make  up  the  report  generator.  After  this  you  are 
prompted  with: 

Enter  DEVICE  OR  FILE: 

You  then  enter  where  you  want  the  Resource  Accounting  information 
displayed.  The  information  can  be  displayed  on  a  device  or  directed 
to  a  file.  For  example,  the  device  could  be  your  terminal: 

Enter  DEVICE  OR  FILE:  TI : 

If  you  wanted  to  put  the  information  in  a  file  named  ACT. REP,  the 
response  would  be: 

Enter  DEVICE  OR  FILE:  ACT. REP 

While  creating  the  report,  you  are  prompted  to  respond  with  where  the 
report  should  be  displayed.  These  prompts  appear  at  junctures  in  the 
report  generating  process  where  certain  parts  of  the  report  can  be 
either  diplayed  or  directed  to  a  file.  For  example,  the  first  prompt 
you  receive  is  at  a  point  where  the  STARTUP  TRANSACTION  part  of  the 
report  can  be  displayed.  The  next  prompt  is  at  a  point  where  the 
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first  part  of  USER  ACCOUNT  BLOCK  TRANSACTION  can  be  displayed.  At 
each  prompt,  you  can  direct  that  part  of  the  report  to  the  same  report 
file,  a  different  report  file,  or  to  a  device. 

To  stop  the  Resource  Accounting  report  process  before  it  is  finished, 
you  must  abort  DTR .  If  this  is  done,  you  must  recopy  [1,2]  QUERY. DIC 
back  into  your  area  before  using  the  example  Resource  Accounting 
report  program. 


17.4.1  SHOW  ACCOUNTING/DATATRI EVE  Command 

This  command  allows  you  to  write  your  own  Resource  Accounting  report 
generator  using  DATATRIEVE-1 1 •  This  command  is  used  to  convert  an 
existing  transaction  file  to  a  file  that  is  readable  by  DATATRIEVE-1 1 . 

Format 

SHOW  ACCOUNTING/DATATRI EVE [ : t rnsf i 1 espec]  outf ilespec 
Parameter 
trnsf ilespec 

Specifies  the  name  of  an  existing  Resource  Accounting  transaction 
f  ile . 

outf ilespec 

Specifies  the  name  of  the  output  file  where  the  converted 
transaction  file  is  to  reside. 


17.5  USER  TASK  INTERFACE  FOR  CREATING  TRANSACTIONS 

You  can  define  and  create  your  own  transactions  and  write  them  into 
the  transaction  file  by  using  specific  entry  points  in  the  Executive 
Accounting  module.  The  task  that  you  write  must  be  privileged.  The 
privileged  task  must  enter  the  system  state  (by  means  of  $SWSTK)  and 
call  one  of  the  following  entry  points  in  the  Executive  module  ACSUB: 
$QTRAN,  $QTRN1 ,  or  $QTRN2 . 

In  general,  before  calling  one  of  the  three  entry  points,  the  task 
must  have  the  address  in  register  RO  of  a  defined  area  (packet)  that 
is  within  the  task.  Also,  the  task  must  supply  in  the  packet  a  value 
for  B.LEN  and  B.TYP  (see  Section  17.6.2).  The  packet  contains  the 
header  and  the  information  that  is  to  be  written  as  a  transaction. 
The  action  taken  by  the  ACSUB  code  depends  on  the  entry  point  called 
by  the  privileged  task. 


17.5.1  Calling  $QTRAN 

The  $QTRAN  routine  automatically  fills  in  the  user-ID  fields  of  the 
packet  from  those  used  by  the  TI:  terminal  of  the  calling  task.  In 
effect,  this  shows  that  the  new  transaction  is  coming  from  the  same 
user  who  ran  the  task. 

To  call  this  entry  point,  the  task  must  have  the  address  of  the 
transaction  packet  in  register  RO.  The  two  fields  B.LEN  (containing 
the  transaction  length)  and  B.TYP  (containing  a  transaction  code  from 
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128  through  255)  must  be  filled  in  and  contained  within  the  packet. 
$QTRAN  obtains  the  transaction  header  from  the  UAB  of  the  privileged 
task,  copies  the  header  except  for  B.LEN  and  B.TYP  into  the  packet, 
time-stamps  the  packet,  and  links  the  packet  into  a  queue  to  be 
written  into  the  transaction  file  by  the  SYSLOG  task.  $QTRAN  does  not 
alter  the  task's  space,  but  copies  the  packet  into  secondary  pool 
space  before  copying  the  header  and  queuing  the  packet  into  the  SYSLOG 
queue . 

Example  17-1  is  an  example  of  the  code  needed  to  call  $QTRAN. 


Example  17-1  Code  That  Calls  $QTRAN 
. MCALL  ACNDF * 

ACNDF*  9  DEFINE  ACCOUNTING  SYMBOLS 

tran:  .blkb  b.mlen 


This  s res  contains  code  that 
describes  the  data  to  be 
written  into  the  transaction 
file* 


MOV  #TRAN  f RO 

MOVB  #BT*MOV,B*TYP<RO> 

MOVB  #B*MLEN»B«LEN(RO> 

CALL  $SUSTK  >  . 

CALL  *GTRAN 


;get  packet  address 

?  FILL  IN  TYPE 
» FILL  IN  LENGTH 
? SWITCH  TO  SYSTEM  STATE 

f  TO  CALL  QUEUE  TRANSACTION  EXEC  ROUTINE 


17.5.2  Calling  $QTRN1 

The  $QTRN1  routine  allows  the  user-ID  fields  to  be  obtained  from  a 
specified  place,  instead  of  assuming  the  current  task. 

To  call  this  entry  point,  the  task  must  have  filled  the  B.LEN  and 
B.TYP  fields  within  the  packet  and  must  have  the  address  of  the 
transaction  packet  in  register  RO.  In  addition,  register  R1  must 
contain  an  APR  value  that  points  to  a  UAB  or  TAB  that  contains  the 
user-ID  data  that  should  be  copied  into  this  transaction. 

The  intent  is  that  the  privileged  task  will  write  a  transaction 
associated  with  another  task.  $QTRN1  time-stamps  the  packet  and 
obtains  the  transaction  header  from  the  UAB  of  the  other  task.  $QTRN1 
then  queues  the  packet  in  the  SYSLOG  queue  to  be  written  into  the 
transaction  file.  $QTRN1  does  not  alter  the  packet  within  the  task, 
but  copies  identifying  information  from  the  specified  UAB  into  the 
secondary  pool,  then  copies  data  into  the  packet,  and  queues  the 
packet  into  the  SYSLOG  queue. 
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Example  17-2  is  an  example  of  the  code  needed  to  call  $QTRN1 . 


Example  17-2  Code  That  Calls  $QTRN1 


♦  MC ALL  ACNDF $ 

A C N D F $  5DEFINE  ACCOUNTING  SYMBOLS 


This  example  assumes  that  R1  contains  the  pointer 
to  the  TCB  of  the  task  for  which  the  transaction 
is  to  be  posted* 


tran:  *blkb  b.mlen 


MOV 

T ♦ A  C  N ( R 1 ) ,R1 

BEG 

10$ 

MOV 

#  T  R  A  N  »  R  0 

MOVB 

♦ 

*BT.M0V,B*TYP<R0) 

MO  VB 

*B»MLENf B*LEN(R0) 

CALL 

$SWSTK  9  . 

CALL 

$QTRN 1 

i START  OF  TRANSACTION 


5GET  OTHER  TASK'S  UAB  OR  TAB  ADDRESS 
?IF  EQ  NO  ACCOUNTING  DATA  PRESENT 
t POINT  TO  TRANSACTION  HERE 


;fill  in  transaction  type 

?  F ILL  IN  TRANSACTION  LENGTH 
JSUITCH  TO  SYSTEM  STATE 
r T 0  CALL  EXECUTIVE  ROUTINES 


17.5.3  Calling  $QTRN2 

The  $QTRN2  routine  assumes  the  calling  task  completely  fills  in  the 
user-ID  area  of  the  transaction.  The  Executive  queues  the  packet  with 
no  modification,  except  for  a  time  stamp. 

To  call  this  entry  point,  the  task  must  have  the  address  of  the 
transaction  packet  in  register  RO.  $QTRN2  does  not  obtain  a  header 
from  any  other  source.  Therefore,  except  for  the  transaction  time, 
the  privileged  task  must  have  completely  filled  in  the  transaction 
header  and  the  transaction  data  contained  within  the  packet.  $QTRN2 
fills  in  the  transaction  time  field  in  the  transaction  header  area  of 
the  packet  created  by  the  user  task  and  queues  the  complete  packet  to 
the  SYSLOG  queue  to  be  written  to  the  transaction  file. 

Example  17-3  is  an  example  of  the  code  needed  to  call  $QTRN2 . 

Figure  17-1  summarily  describes  the  privileged  task  interface  just 
discussed.  Section  17.6.2  contains  a  description  of  the  header  area 
fields. 
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Example  17-3  Code  That  Calls  $QTRN2 


*  M  C  A  L  L.  A  C  N  D  F  $ 

ACNDF $  {DEFINE  ACCOUNTING  SYMBOLS 


♦ 

tran:  *blkb  b ♦  mlen 


This  ares  contains  the  code  thst 
describes  the  header  and  data  to 
be  written  into  the  transaction 
file* 


MOV 

♦  T  R  A  N  >  R  0 

MO  VB 

♦BT.MOVf B.TYP(RO) 

MO  VB 

#B*MLEN?B*LEN(R0) 

MOV 

UIDf B.UID(RO) 

MOV 

U I D  +  2  *  B  *  U I  D  +  2  <  R  0  ) 

MOV 

ACN { B  *  ACN ( R0  ) 

MOV 

TIDfB.TID(RO) 

CALL 

$  S  W  S  T  K  >  10$ 

CALL 

RETURN 

$  Q  T  R  N  2 

10$  J 


{POINT  TO  TRANSACTION 
{FILL  IN  TRANSACTION  TYPE 
{FILL  IN  TRANSACTION  LENGTH 
{USER  SESSION  ID 
{SECOND  HALF 
{ ACCOUNT  NUMBER 
{TERMINAL  ID 
{SWITCH  TO  SYSTEM  STATE 


{TO  USER 


17.6  ACCOUNT  BLOCKS 

There  are  two  types  of  Resource  Accounting  account  blocks:  the 
memory-resident  and  non-memory-resident  account  blocks.  The 
memory-resident  account  blocks  are  the  Task  Account  Block  (TAB) ,  the 
User  Account  Block  (UAB) ,  and  the  System  Account  Block  (SAB) .  The 
Task  Account  Block  (TAB)  accumulates  accounting  data  per  task  and 
stays  in  secondary  pool  as  long  as  a  task  is  active.  The  User  Account 
Block  (UAB)  for  each  logged-on  user  accumulates  the  Accounting  data 
and  stays  in  secondary  pool  as  long  as  the  user  is  logged  on.  The 
system's  UAB  accumulates  data  for  tasks  running  on  terminal  CO:.  The 
SAB  stays  in  secondary  pool  and  accumulates  system  accounting  data  as 
long  as  Resource  Accounting  is  running. 

All  other  account  blocks  are  non-memory-resident;  that  is,  they  are 
created  and  filled  when  any  transaction  occurs,  copied  by  Accounting 
into  secondary  pool,  and  immediately  written  into  the  transaction 
file,  and  the  space  is  deallocated  back  to  secondary  pool. 

All  of  the  blocks  have  a  header  area  that  contains  the  same  fields  and 
offsets.  In  addition,  the  TAB,  the  UAB,  and  the  SAB  have  data 
accumulation  field  areas  following  the  header.  All  data  accumulation 
fields  have  the  same  offsets.  The  information  specific  to  the  TAB, 
UAB,  and  SAB  follows  the  accumulation  areas. 
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CALLING  $QTRAN 
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Figure  17-1 


Privileged  Task  Interface  Overview 
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You  can  find  the  size  and  the  description  of  the  offsets  in  Section 
17. 6,2.  The  offsets  are  grouped  logically;  the  header  offsets  are 
described  in  one  group,  the  accumulation  field  offsets  in  another 
group ,  and  so  forth.  The  account  and  transaction  block  diagrams  in 
Section  17.6.1  show  how  these  groups  fit  together  to  make  a  functional 
account  and  transaction  block.  The  account  and  transaction  block 
diagrams  are  shown  before  the  offset  descriptions. 

Check  the  [ 126 , 10] ACNDF .DOC  file  on  the  distribution  kit  for  the 
correct  numeric  offsets  if  you  plan  to  write  a  program  that  uses  the 
offsets.  In  MACRO-11  programs,  use  the  symbolic  names  defined  by  the 
ACNDF$  macro  in  [ 1 f 1] EXEMC . MLB .  The  names  will  not  change  even  if 
their  associated  offsets  change. 


NOTE 

The  UAB ,  SAB ,  mount,  and  print  despooler 
transaction  blocks  have  changed  for  this 
version  of  RSX-11M-PLUS .  An  analysis 
program  written  for  the  last  version 
will  require  modification  if  numeric 
field  offsets  were  used  instead  of  the 
symbolic  offsets  resolved  from  the 
ACNDF $  macro  or  EXELIB.OLB.  A  program 
can  distinguish  the  two  forms  of 
transactions  by  the  length  code. 
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17.6.1  Account  and  Transaction  Block  Diagrams 
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System  Account  Block 
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OCT  DEC 


0 

0 

B.LNK 

2 

2 

B.TYP 

B.LEN 

4 

4 

B.TIM 

12 

10 

B.UID 

16 

14 

B.ACN 

20 

16 

B.TID 

22 

18 

B.DNAM 

24 

20 

B.DUNT 

UNUSED 

26 

22 

B.DLBL 

42 

34 

B.DMST 

44 

36 

B.DUIC 

46 

38 

B.DVPR 

50 

40 

B.DACP 

54 

44 

B.MLEN 

ZK-602-82 

Mount  Device  Transaction  Block 
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OCT 


12 

16 

20 

22 

24 

26 


DEC 


0 

B.LNK 

2 

B.TYP 

B.LEN 

4 

B.TIM 

10 

B.UID 

14 

B.ACN 

16 

B.TID 

18 

B.DNAM 

20 

B.DUNT 

UNUSED 

22  B.DLEN==. 

ZK-603-82 


Dismount  Device  Transaction  Block 


OCT 

0 

2 

4 


12 

16 

20 

22 

30 

36 


DEC 


0 

B.LNK 

2 

B.TYP 

B.LEN 

4 

B.TIM 

10 

B.UID 

14 

B.ACN 

16 

B.TID 

18 

B.TOLD 

24 

B.TNEW 

30  B.TMLN==. 

ZK-604-82 


System  Time  Change  Transaction  Block 


o 
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OCT 

0 

2 

4 


12 

16 

20 

22 

26 

30 

32 

34 

36 

37 


DEC 

0 

2 

4 


10 

14 

16 

18 

22 

24 

26 

28 

30 

31 


B.PLEN 

ZK-605-82 


Print  Despooler  Transaction  Block 


OCT  DEC 


o  o 

2  2 

4  4 


12  10 


16  14 

20  16 

22  18 

24  20 


43  35 

Login  Transaction  Block 


ZK-606-82 
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OCT 


12 

16 

20 

22 


30 

32 

34 

36 


DEC 


0 

B.LNK 

2 

B.TYP 

B.LEN 

4 

B.TIM 

10 

B.UID 

14 

B.ACN 

16 

B.TID 

18 

B.RNAM 

24 

B.RCDS 

26 

B.RDEV 

28 

B.RUNT 

B.RSOP 

30  B.RLEN-=. 


ZK-607-82 


Card  Reader  Spooling  Transaction  Block 


OCT 

0 

2 

4 

12 

16 

20 

22 

26 

32 

34 

36 

42 

46 

50 

52 

54 

56 


DEC 

0 

2 

4 


10 


14 
16 
18 

22 

26 
28 
30 

34 

38 
40 
42 
44 
46 

Device  Statistics  Block 


B.LNK 


B.TYP 


B.LEN 


B.TIM 


B.UID 


B.ACN 


B.TID 


X.NAME 


X.IOC 


X.ERHL 


X.ERSL 


X.ERSC 


X.ERHC 


X.WCNT 


X.CYLC 


X.CCYL 


X.FCUR 


X.FLIM 


X.DNAM 


X.UNIT 


UNUSED 


X.LGTH  ==. 


ZK-902-82 


17-33 


RSX-11M-PLUS  RESOURCE  ACCOUNTING 


17.6.2  Account  and  Transaction  Block  Offset  Definitions 

The  header  area  fields  precede  the  accumulation  fields  for  the  TAB, 

UAB ,  and  SAB.  The  header  area  fields  also  precede  each  transaction 
block. 

The  header  provides  user  identification  by  two  fields  (B.UID  and 
B.ACN)  that  appear  in  every  transaction.  These  fields  are  the  unique 
session  identification  and  the  account  number.  The  unique  session 
identification  is  two  words  long.  The  first  word,  the  session 
identification,  is  three  RAD50  characters  supplied  by  the  user  when  he 
creates  the  system  account  by  using  the  ACNT  program.  The  second  word 
is  a  unique  number  assigned  by  the  system  at  login.  Thus,  it  is 
possible  to  match  every  transaction  with  the  login  session  that 
produced  it.  The  account  number  field  is  a  binary  word  (entered 
through  ACNT)  that  is  copied  into  every  transaction.  Resource 
Accounting  does  not  use  either  of  these  fields,  except  to  ensure  that 
they  appear  in  every  transaction. 


Header  Area  Fields 


Offset 


Size  or 

Value  Definition 


B.LNK: : 
B.TYP: : 


. BLKW  1 
. BLKB  1 


BT. SAB==1 
BT. UAB==2 
BT. TAB==3 
BT. SS==11 
BT. INV==1 2 
BT. TIM==1 3 
BT. ALL==14 
BT.DEA==15 
BT. M0U==1 6 
BT. DM0==17 
BT. PRT==2  0 


BT. LOG==23 
BT. CRH==24 
BT. DST==2  5 
BT. RTP==26 
BT. INP==2  7 


Start  of  header  area: 

Link  to  next  in  SYSLOG  queue 
Transaction  type: 

000  through  127  -  reserved  for  DIGITAL 

use 

128  through  255  -  reserved  for  customer 

use 

System  Account  Block  (SAB) 

User  Account  Block  (UAB) 

Task  Account  Block  (TAB) 

Accounting  startup  transaction 
Invalid  login  transaction 
System  time  change  transaction 
Allocate  device  transaction 
Deallocate  device  transaction 
Mount  device  transaction 
Dismount  device  transaction 
Print  despooler  transaction 
Reserved 
Reserved 

Login  transaction 

Crash  recovery  transaction 

Device  Statistics  (UCB  Extension) 

Reset  Transaction  Parameters 
Card  Reader  Spooling  Transaction 


B.LEN: : 

.BLKB 

B.TIM:  : 

.BLKW 

B. HID==. 

B.UID: : 

.BLKW 

B .  ACN :  : 

.BLKW 

B.TID: : 

.BLKB 

.BLKB 

B.HEND==. 

Transaction  length  in  bytes 

Ending  time  of  transaction  (supplied  by 

$QTRAN , $QTRN1 , $QTRN2) 

Start  of  header  identification  area 
Unique  session  identification 
First  word  -  RAD50 
Second  word  —  binary 
Account  number 

ASCII  terminal  type:  V  -  virtual, 

T  -  real,  B  -  batch,  C  -  console 
Unit  number 

End  of  header  identification  area 
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Accumulation  Fields  for  User  Account  Block,  Task  Account 
Block,  and  System  Account  Block 


B .CPU : : 

.  BLKW 

2 

Total  CPU  time  used 

B.DIR: : 

.  BLKW 

2 

Total  directive  count 

B.QIO: : 

.BLKW 

2 

Total  QIO$  count 

B.TAS: : 

.BLKW 

2 

Total  task  count  (not 

.BLKW 

3 

Reserved 

B  •  B EG :  : 

.BLKW 

3 

Beg  inning/ log  in  time 

B.CPUL: : 

.BLKW 

2 

CPU  time  limit  in  TAB 
(not  used  in  SAB) 

B . PNT : : 

.BLKW 

1 

Pointer  to  SAB  if  sysi 
to  be  collected.  Eqi 

B.STM: 


. BLKB  1 
BS.ACT==200 
BS . CRH==1 00 
BS.LGO==40 

BS.CO==40 
BS. TML==20 


BS. ZER==10 
BS. SCN==4 


s  0  i f  no 

system  statistics  collection.  In  TAB 
this  points  to  UAB.  In  UAB  points  to 
SAB  if  SYSTEM-STATISTICS: YES  or  zero. 

In  SAB  always  zero. 

Status  mask 

Control  block  active  ( UAB ,  TAB) 

Record  from  TMP  file  after  crash  (UAB ,  SAB) 
Logged  off  with  outstanding 
activities  (UAB  only) 

Tasks  TI:  is  CO:  (TAB  only) 

TAB  exists  only  for  time  limit  (TAB  only) 
TABS  with  this  bit  set  will  not 
be  written  to  the  transaction  bite. 

Last  CPU  interval  was  zero  length  (TAB ,  UAB) 
Transaction  ready  for  write  to  scan  (UAB , 
SAB)  file 


User  Account  Block 


Note:  User 

Account  Blocks 

B . USE : : 

.BLKB 

1 

B. ACT: : 

.BLKW 

1 

B.UUIC: : 

.BLKW 

1 

B.UCB: : 

.BLKW 

1 

B.LGO: : 

.BLKW 

3 

B.ULNK: : 

.BLKW 

1 

B.RNA: : 

.BLKW 

3 

B.NAM : : 


B • ULEN== • 


.BLKB  14. 


.BLKB 

.BLKB 


Use  count 

Number  of  currently  active  tasks 
Login  UIC 
Pointer  to  UCB 
Logoff  time 

Link  to  next  User  Account  Block 
Location  in  system  account  file  - 
(offset ,  VBN-hi ,  VBN-lo) 

This  will  be  inaccurate  if  the 
account  file  is  changed  (additions, 
deletions,  sorts) . 

Last  name  of  user 
First  initial  of  user 
Unused  byte 

User  Account  Block  Length 
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Task  Account  Block 


NOTE:  Task  Account  Blocks  must  end  on  a  word  boundary. 


B.PRI: : 

.BLKB 

1 

Highest  running  priority 

B.TNAM: : 

.BLKW 

2 

Task  name 

B.TCB: : 

.BLKW 

1 

TCB  address 

B.TST3: : 

.  BLKW 

1 

T.ST3  from  task's  TCB 

B.CUIC: : 

.BLKW 

1 

Reserved  for  future  status  bits 

.BLKW 

1 

Current  UIC  of  task 

B.PUIC: : 

.BLKW 

1 

Protection  UIC  of  task 

B.CTXT: : 

.BLKW 

2 

Number  of  context  loads 

B.TCKP: : 

.BLKW 

2 

Times  task  has  been  checkpointed 

B.OVLY: : 

.BLKW 

2 

Number  of  disk  overlay  loads 

B.EXST: : 
B.TLEN==. 

.BLKW 

2 

Exit  status  and  abort  code  0 

TAB  length 

System  Account  Block 


B.SHDN: : 


B.UHD: 

B.ULO: 

B.ULT: 

B.CKP: 

B.SHF: 

B.RND: 


. BLKB  1 


. BLKW  1 
• BLKW  1 
.BLKW  2 
.BLKW  2 
.BLKW  2 
.BLKW  2 


Accounting  shutdown  reason  code 

1  -  Maintenance 

2  -  Reboot 

3  -  Scheduled  shutdown 

4  -  Accounting  shutdown  by  Shutup 

task 

5  -  Other 

User  Account  Block  listhead 
Number  of  users  currently  logged  on 
Total  number  of  logons 
Total  number  of  checkpoints 
Total  number  of  shuffler  runs 
Number  of  CPU  intervals  rounded  up 
to  1/2 


O  The  abort  codes  are: 


S. CACT=-4 . 
S . CEXT=-2 . 
S. COAD=0 • 

S . CSGF=2 . 
S. CBPT=4 • 

S . CI0T=6 • 
S. CILI=8 • 

S . CEMT=1 0 • 
S • CTRP=1 2 • 
S . CFLT=1 4 • 
S. CSST=16 . 
S.CAST=18. 
S. CAB 0=20. 
S . CLRF=22 . 
S. CCRF=24 . 
S. IOMG=26. 
S . PRTY=28 • 
S . CPMD=30 • 
S . CELV=32 . 
S • CINS=3  4 . 
S . CAFF=36 . 

S • CCSM=38 • 
S . C0TL=4  0 • 


Task  still  active 

Task  exited  normally 

Odd  address  and  traps  to  4 

Segment  fault 

Break  point  or  trace  trap 

IOT  instruction 

Illegal  or  reserved  instruction 
Non-RSX  EMT  instruction 
TRAP  instruction 

PDP-11/40  floating  point  exception 

SST  abort-bad  stack 

AST  abort-bad  stack 

Abort  via  directive 

Task  load  request  failure 

Task  checkpoint  read  failure 

Task  exit  with  outstanding  I/O 

Task  memory  parity  error 

Task  aborted  with  PMD  request 

TI:  virtual  terminal  was  eliminated 

Task  installed  in  2  different  systems 

Task  aborted  due  to  bad  affinity  (required  by  runs  are 
offline  or  not  present) 

Bad  parameters  or  bad  stack 
Task  has  run  over  its  time  limit 
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B • FID: : 
B.DVNM: 
B.UNIT: 
B. EXTS: 
B.LSCN: 
B.SCNR: 
B.DSCN: 


B . SLEN== • 


B • SSLN== • 


B.OFID: : 
B . ODNM : : 
B.OUNT: : 
B.NFID: : 
B.NDNM : : 
B.NUNT: : 
B.OEXS: 2 
B.NEXS  2 2 
B.OSCR2  2 
B.NSCR2  2 
B . ODSC  2 2 
B.NDSC  2 2 
B. RTLN== 


B. CTLS  2 2 
B.CSRT2  2 
B . CRSN  2 2 
B . CLEN== • 


B. INAM  2 2 
B. IUIC  2 2 
B. IPSW  2 2 
B. ILEN== . 


B . DNAM 2  2 
B.DUNT2  2 
B . DLEN== • 


. BLKW  3 
. BLKB  2 
.BLKW  1 
.BLKW  1 
.BLKW  3 
.BLKW  1 
.BLKW  1 

.BLKW  9. 


File-ID  of  transaction  file 
Device  of  transaction  file 
Unit  of  transaction  file 
Extend  size  for  transaction  file 
Time  of  last  scan 
Scan  rate  in  seconds 
Device  statistical  scan  rate  (in 
seconds) 

Reserved 

System  Account  Block  length 


SYSLOG  Startup  Transaction  Block 


Transaction  length 


Set  Accounting  Transaction  Block 


.BLKW  3 
.BLKB  2 
.BLKW  1 
.BLKW  3 
.BLKB  2 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 
.BLKW  1 


File-ID  of  old  transaction  file 
Device  of  old  transaction  file 
Unit  of  old  transaction  file 
File-ID  of  new  transaction  file 
Device  of  new  transaction  file 
Unit  of  new  transaction  file 
Extend  size  for  old  transaction  file 
Extend  size  for  new  transaction  file 
Old  scan  rate  in  seconds 
New  scan  rate  in  seconds 
Old  statistical  scan  rate 
New  statistical  scan  rate 
Transaction  length 


Crash  Recovery  Transaction  Block 


.BLKW  3 
.BLKW  1 
.BLKB  60. 


Time  of  last  scan  before  crash 
Scan  rate  before  crash 
ASCII  text  explaining  crash 
Transaction  length 


Invalid  Login  Transaction  Block 


.BLKB  14. 
.BLKB  6. 
.BLKB  6. 


Name  from  login  line 
UIC  from  login  line 
Password  from  login  line 
Transaction  length 


Device  Transaction  for  Disk  Accounting 
(ALLOCATE ,  DEALLOCATE ,  MOUNT ,  and  DISMOUNT) 

.BLKW  1  ASCII  device  name 

.BLKB  1  Octal  device  unit  number 

Transaction  length  for  ALLOCATE , 
DISMOUNT,  and  DEALLOCATE 
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Only 

Appear 

for  MOUNT  Transactions 

.BLKB 

1 

Unused  byte 

B.DLBL: : 

.BLKW 

6 

Volume  label 

B.DMST:  : 

.BLKW 

1 

Mount  Status  Bits 

B.DUIC:  : 

.BLKW 

1 

Owner  UIC 

B . DVPR : : 

.BLKW 

1 

Volume  protection  code 

G 

B.DACP: : 
B.MLEN==. 

.BLKW 

2 

Name  of  ACP  for  device 

Length  of  MOUNT  transactions 

System  Time 

Change  Transaction  Block 

B. TOLD: : 

.BLKB 

6 

Old  time  (yr,  mon, 

day. 

hr,  min. 

B.TNEW: : 
B.TMLN==. 

.BLKB 

6 

New  time  (yr,  mon. 
Transaction  length 

day. 

hr,  min. 

sec) 

sec) 


Print  Despooler  Transaction  Block 


B . PNAM : : 
B.PPGS: : 
B.PNFIs : 
B.PFRM: : 
B.PPRI: : 
B.PDEV: : 
B.PPUN: : 
B.PLEN==. 


• BLKW  3 
. BLKW  1 
.BLKW  1 
. BLKB  1 
. BLKB  1 
.BLKW  1 
.BLKB  1 


Print  job  name 
Page  count 


(RAD50) 


Number  of  files  printed 
Form  number 
Print  priority 
Print  device  name  (ASCII) 
Unit  number  of  print  device 
Transaction  length 


Card  Reader  Spooling  Transaction  Block 


B . RNAM : : 

.BLKW 

3 

Batch  or  print  job  name 

B.RCDS: : 

.BLKW 

1 

Number  of  cards  read 

B.RDEV: : 

.BLKW 

1 

Reader  device  name  (ASCII) 

B . RUNT : : 

.BLKB 

1 

Unit  number  of  reader  device 

B.RSOP: : 

.BLKB 

1 

Submit  or  print  (0=SUBMIT,  1 

B.RLEN==. 

Transaction  length 

©  The  volume  protection  codes  are: 


Bits 

Protection 

0-3 

system 

4-7 

owner 

8-11 

group 

12-15 

world 

The  bit  settings  within  each  protection  group  are: 
Bit  Access  denied  (if  bit  set) 


0 

1 

2 

3 


read 
write 
create 
del ete 
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Login  Transaction  Block 


B.LUIC: : 

B . LN AM : : 

B . LLEN== . 


, BLKW  1 
, BLKB  14. 
. BLKB  1 


Login  UIC 
User' s  last  name; 
User's  first  initial 
Transaction  length 


The  following  globals  are  also  defined: 


B . MAXL==1 28 • 
B . MINL==9 • 


Maximum  transaction  length  (words) 
Minimum  transaction  length  (words) 


Device  Statistics  Block 


X.NAME: : 

:  .BLKW 

2 

Drive  name  in  RAD50 

X. IOC: : 

.BLKW 

2 

I/O  Count 

X.ERHL: 

.BLKB 

1 

Hard  error  limit 

X.ERSL: 

.BLKB 

1 

Soft  error  limit 

X.ERSC: 

.BLKB 

1 

Soft  error  count 

X.ERHC: 

.BLKB 

1 

Hard  error  count 

X.WCNT: 

.BLKW 

2 

Words  transferred  count 

X.CYLC: 

.BLKW 

2 

Cylinders  crossed  count 

X.CCYL: 

.BLKW 

1 

Current  cylinder 

X.FCUR: 

.BLKB 

1 

Current  fairness  count 

X.FLIM: 

Fairness  count  limit 

X.DSKD: 

.BLKB 

1 

Disk  direction  (high  bit  l=out) 

X.DNAM: 

.BLKB 

1 

Device  name  for  accounting 

X.UNIT: 

.BLKB 

1 

Unit  number  for  accounting 

.BLKB 

1 

Unused 

X. LGTH== 

“  • 

Length  of  the  UCB  extension 
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17.6.3  Account  Block  Linkages 


ZK-166-81 


Figure  17-2  Account  Block  Linkages 
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0  Terminal  TT5 : ,  which  is  indicated  by  the  UCB,  is  that  of  the 
most  recently  logged-on  user.  The  user  of  this  terminal  has 
started  two  tasks ,  which  are  indicated  by  the  two  Task 
Control  Blocks  (TCB)  that  contain  pointers  to  the  UCB 
(T.UCB)  and  each  associated  TAB  (T.ACN) .  Each  TAB  then 
points  to  the  terminal's  UAB.  The  total  usage  of  terminal 
TT5 :  is  totaled  in  the  associated  UAB. 

0  Terminal  TT7 :  is  that  of  the  next  most  recently  logged-on 
user.  The  user  has  started  a  task  indicated  by  the  single 
TCB,  which  points  to  a  TAB  which  points  to  a  UAB.  The  total 
usage  of  terminal  TT7 :  is  totaled  in  the  associated  UAB. 

0  The  CO:  console  terminal  has  associated  with  it  a  single 
TCB  that  indicates  a  system  task  is  running.  In  effect,  the 
system  is  also  a  user  and  has  system  usage  accumulated  at 
the  task  level  in  the  TAB  and  totaled  in  the  UAB  associated 
with  the  CO:  terminal. 

0  The  SAB  contains  the  usage  totals  for  all  the  users 
including  the  system  itself.  The  B.UHD  pointer  in  the  SAB 
points  to  the  UAB  of  the  most  recently  logged-in  user. 
B.UHD  and  the  B.ULNK  words  in  each  UAB  are  the  linkages  that 
are  used  when  Accounting  periodically  writes  the  UABs  to  the 
scan  file. 

0  The  pointer  to  the  SAB  ($SABPT)  is  in  the  Executive  module 
SYSCM • 

0  The  pointer  to  the  system  UAB  ($SYUAB)  is  in  the  Executive 
module  SYSCM. 


NOTE 

Although  all  active  UCBs  point  to  the 
appropriate  UABs  using  U.UAB,  this  is 
not  true  for  CO:.  U.UAB  does  not  exist 
for  CO:,  but  instead  is  reflected  by 
location  $SYUAB. 


17.7  SYSTEM  RESOURCES  USED 


The  following  sections  discuss  the  amount  of 
Resource  Accounting  uses.  Secondary  pool  usage 
minimum  to  an  amount  determined  by  the  number  of 


system  space  that 
varies  from  a  certain 
logged-in  users  and 


event-associated  transactions. 


17.7.1  Executive  Space  Requirements 

Accounting  support,  which  is  a  SYSGEN  option,  takes  up 
532  words. 

Space  in  system  pool  is  required  for  one  active 
file. 


approximately 
and  one  open 
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CONTINUE 


18.2.4  CONTINUE  Command 

The  CONTINUE  command  allows  you  to  restart  Shadow  Recording  on  the 
same  two  disks  that  you  were  using  when  the  STOP  command  was  issued. 
The  CONTINUE  command  assumes  that  the  two  disks  are  physically  alike, 
and  it  does  not  check  the  disks  for  equality.  You  must  be  sure  that 
no  writing  occurred  on  the  primary  or  secondary  disks  after  you  issued 
the  STOP  command. 

The  CONTINUE  command: 

•  Assumes  that  the  primary  and  secondary  disks  are  identical 

•  Verifies  that  the  primary  disk  is  in  Files-11  format  and 
mounted  properly 

•  Verifies  that  the  secondary  disk  is  mounted  foreign 

•  Verifies  that  both  disks  are  identical  device  types 


•  Sets  up  the  Shadow.  Recording  data  v  structure,  which  starts 
Shadow  Recording  within  the  Executive 

Format 

CONTINUE  ddnn :  TO  ddxx: 

Parameters 
ddnn : 


The  device  unit  of  the  primary  device 


ddxx : 


The  device  unit  of  the  secondary  device 
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DISPLAY 


18.2.5  DISPLAY  Command 

The  DISPLAY  command  shows  all  shadowed  pairs. 

Format 

DISPLAY 

Entering  the  DISPLAY  command  causes  a  display  of  the  shadowed  device 
pairs  in  the  following  format: 

UMB  PRIMARY  SECONDARY 

xxxxxx  ddnn:  ddxx: 


xxxxxx 

The  address  of  the  UMB  control  block  for  Shadow  Recording.  This 
control  block  is  in  the  system  Executive  pool  space. 

ddnn: 

The  device  unit  of  the  primary  device 

ddxx : 

The  device  unit  of  the  secondary  device 
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18.3  BAD  BLOCK  HANDLING 

Except  for  the  START  command,  which  copies  the  primary  disk  to  the 
secondary  disk,  the  Executive  writes  the  data  from  a  task  buffer  to 
the  primary  disk  and  then  writes  it  from  the  task  buffer  to  the 
secondary  disk.  if  write  errors  occur  on  one  of  the  disks,  you  may 
not  know  it  until  the  Executive  attempts  to  read  the  block  in  error. 

To  be  notified  of  write  errors  as  they  occur,  you  can  run  Shadow 
Recording  with  write  check  for  both  disks  of  the  shadowed  pair.  The 
MCR  command: 

>SET  /WCHK=ddnn : 

enables  write  check  on  the  device  that  you  specify  in  ddnn:.  However, 
be  aware  that  a  write  check  of  every  write  operation  takes  more  time 
to  execute  than  a  write  only. 

When  write  check  is  enabled,  the  Shadow  Recording  program  prints  the 
error  messages  on  the  console  terminal.  These  error  messages  consist 
of  device  and  logical  block  numbers  when  available. 

In  the  case  of  a  read,  the  Executive  reads  from  the  primary  disk 
first.  If  it  encounters  an  error  on  the  primary  disk,  it  reads  the 
same  record  from  the  secondary  disk.  It  is  extremely  unlikely  that 
both  disks  would  develop  an  error  in  exactly  the  same  place.  However, 
if  they  do,  a  notification  of  read  errors  on  the  secondary  disk  means 
that  the  primary  disk  is  also  bad  in  the  same  location. 

If  read  errors  occur,  several  procedures  can  be  followed  as  discussed 
next. 


18.3.1  Errors  on  the  Primary  Disk 

If  errors  occur  when  the  Executive  tries  to  read  from  the  primary 
disk,  the  Executive  then  tries  to  read  the  same  record  from  the 
secondary  disk.  You  are  notified  of  the  errors  by  a  message  on  the 
console  and,  at  this  point,  you  may  decide  to  let  your  task  continue. 
If  you  do  decide  to  let  your  task  continue,  be  aware  that  the  shadowed 
pair  are  no  longer  alike. 

If  you  decide  not  to  let  your  task  continue,  stop  the  processing  task 
(or  tasks)  and  use  the  STOP  command  to  stop  Shadow  Recording.  The 
secondary  disk  contains  all  the  data  that  was  on  the  primary  disk, 
including  the  bad  block  record.  Use  the  secondary  disk  as  the  new 
primary  disk.  Designate  a  new  device  of  the  same  type  for  the  new 
secondary  disk.  Mount  the  new  secondary  disk  on  the  secondary  device 
as  foreign. 

After  mounting  the  old  secondary  disk  on  the  primary  device  as  the  new 
primary  disk,  issue  the  START  command.  The  START  command  causes  the 
copying  of  the  primary  disk  to  the  secondary  disk,  including  the  bad 
block  record. 


18.3.2  Errors  on  the  Secondary  Disk 

If  errors  occur  on  the  secondary  disk,  the  shadow  of  the  primary  data 
is  no  longer  valid.  Shadow  Recording  should  be  stopped,  a  new 
secondary  disk  should  be  mounted,  and  Shadow  Recording  restarted.  The 
catchup  task  will  then  copy  the  primary  disk  to  the  new  secondary 
disk. 
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18.3.3  Errors  on  the  Primary  and  Secondary  Disk 


The  simultaneous  occurrence  of  bad  data  in  the.  same  blocks  of  two 
different  disks  is  unlikely,  and  this  kind  of  error  n° 

recoverable.  However,  whether  or  not  an  error  occurs  at  the  same  or 
different  places  on  both  disks,  the  only  recourse  is  to  stop  Shadow 
Recording  and  your  tasks.  Then,  select  a  new  primary  disk  and  new 
secondary  disk,  mark  the  bad  block  information  on  the  new  primary  disk 
as  before,  and  copy  the  old  primary  disk  to  the  new  primary  disk. 

If  the  error  occurred  on  different  blocks  on  both  disks,  the 
previously  processed  information  can  be  salvaged  by  using  the  old 
primary  and  secondary  as  a  shadowed  pair  input  to  the  Backup  and 
Restore  Utility  (BRU) .  BRU  copies  all  the  data  that  is  on  the  input 
disk  and  writes  it  to  the  output  disk.  If  you  use  a  shadowed  pair  as 
input  to  BRU,  only  the  good  data  is  written  to  the  output  disk  because 
of  the  alternative  read  that  the  Executive  does  on  the  secondary  disk 
if  primary  disk  errors  occur. 


Using  BRU  will  not  give  you  a  new  primary  disk.  You  must  create  a  new 
primary  disk  from  the  output  of  BRU  as  discussed  in  Section  18.1. 

Information  about  how  to  use  BRU  is  in  the  RSX-1 1M/M-PLUS  Utilities 
Manual . 


18.4  SHADOW  RECORDING  MESSAGES 

hh:mm:ss  —  Handler  Error  code-nn.  on  ddnn: 

Shadow  Pair:  ddnn:  ddxx: 

Task:  xxxxxx 

Logical  Block:  nnn. 

Bytes  in  xfer:  nnn. 

File  ID:  n,n 
File  Name:  xxxxxx 

nn •  errors  lost  due  to  saturation. 

Explanation: 
hh :mm: ss 

The  time  in  hoursf  minutes,  and  seconds  of  the  error 
code-nn. 

The  I/O  error  code  (decimal)  for  the  error 

I/O  error  codes  are  summarized  in  the  RSX-11M-PLUS  Mini 
Reference  Manual . 


File  ID 
File  Name 

The  File  ID  and  File  name  are  printed  only  when  they  can  be 
determined  at  the  time  of  the  error. 


nn.  errors  lost 


When  an  error  occurs  on  a 
notifies  the  shadow  error 
above  message  on  the  console  terminal, 
the  information  about  the  error  in 
reporting  task  to  pick  up  and  print. 


shadowed  disk,  the  Executive 
reporting  task  that  prints  the 
The  Executive  stores 
pool  for  the  error 
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If  a  number  of  errors  occur  rapidly,  pool  can  fill  up  with 
this  error  information  before  the  error  reporting  task  can 
process  it  and  there  may  be  no  pool  left  to  run  the  system. 
Therefore,  the  Executive  allows  only  a  certain  number  of 
errors  to  be  queued  in  pool  at  one  time.  If  this  limit  has 
been  reached  and  more  errors  occur,  the  Executive  does  not 
process  them  (it  keeps  track  of  how  many  it  did  not 
process) .  This  message  tells  the  user  how  many  errors  were 
ignored  in  this  way.  "Saturation"  refers  to  pool  being 
saturated  with  as  many  error  messages  as  the  Executive  limit 
allows . 

This  message  is  only  printed  when  errors  have  not  been 
processed. 

User  Action:  See  Section  18. 3,  Bad  Block  Handling. 


SHA  —  Abort  error 

Explanation:  This  message  occurs  if  the  Shadow  Recording  ABORT 

command  cannot  abort  Shadow  Recording  during  catchup. 

User  Action:  Wait  until  catchup  terminates  and  then  issue  the 
STOP  command. 


SHA  —  Bad  indirect  file  specification 

Explanation:  The  indirect  command  file  name  is  incorrect. 

User  Action:  Reissue  the  indirect  command  file  specification. 

SHA  —  Bad  volume  type 

Explanation:  The  disk  is  not  in  Files-11  format  or  the  primary 

and  secondary  devices  are  different  device  types. 

User  Action:  Check  the  command  line  or  devices  that  you  are 
trying  to  use. 


SHA  —  Catch-up  completed 

Explanation:  This  is  an  information  message.  The  primary  disk 

has  been  completely  copied  to  the  secondary  disk. 

User  Action:  None. 


SHA  —  Catch-up  in  progress 

Explanation:  You  have  tried  to  issue  a  STOP  command  during  the 

catchup  process. 

User  Action:  Issue  an  ABORT  command  if  catchup  is  still  in 
progress. 


SHA  —  I/O  error  on  logical  block  nnn. 

Explanation:  An  I/O  error  occurred  during  catchup. 

User  Action:  None.  If  the  I/O  errors  are  frequent,  enter  the 
ABORT  command,  change  disks,  and  restart  Shadow  Recording. 
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SHA  —  Illegal  command 

Explanation:  The  command  that  you  entered  is  not  a  legal 

command • 

User  Action:  Reenter  the  command. 

SHA  —  Input  error  on  input  command  file 
FILE= 

Explanation:  An  error  occurred  while  the  indirect  command  file 

was  being  read. 

User  Action:  Take  appropriate  action;  for  example,  use  a 
different  indirect  command  file,  or  use  a  copy  of  the  specified 
command  file. 

SHA  —  Illegal  parse  data  (internal  error) 

Explanation:  This  is  an  internal  system  error.  The  command  was 

correctly  entered . 

User  Action:  Reenter  the  command. 

SHA  —  Invalid  device 

Explanation:  The  device  is  not  a  disk  device. 

User  Action:  Check  the  device  specification  and  the  device. 

SHA  —  Maximum  indirect  command  file  depth  exceeded 

Explanation:  The  indirect  command  file  was  nested  to  too  many 

levels.  Only  three  levels  are  allowed. 

User  Action:  Check  the  indirect  command  file. 

SHA  —  No  room  available  for  UMB 

Explanation:  Not  enough  pool  space  exists  to  allocate  space  for 

the  UMB  control  block  for  Shadow  Recording. 

User  Action:  Check  your  system.  The  system  may  be  on  the  verge 
of  running  out  of  pool  space. 

SHA  —  Not  a  shadowed  pair 

Explanation:  When  STOP  or  ABORT  was  issued,  the  wrong  device  was 

specified. 

User  Action:  Reissue  the  command  with  the  correct  device  unit. 

SHA  —  Open  error  on  input  command  file 
FILE= 

Explanation:  The  input  command  file  could  not  be  found. 

User  Action:  Check  the  command  file  and  its  location. 
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SHA  —  Privileged  command 

Explanation:  You  are  not  using  a  privileged  account  or  terminal. 
User  Action:  Log  in  on  a  privileged  account  or  terminal. 

SHA  —  Send/Receive  error 

Explanation:  A  RECEIVE  Executive  directive  error  occurred  in 

Shadow  Recording  during  catchup. 

User  Action:  None.  This  is  a  system  error. 

SHA  —  Shadow  Recording  not  in  system 

Explanation:  Shadow  Recording  is  not  part  of  your  system. 

User  Action:  Shadow  Recording  must  be  specified  at  system 
generation. 

SHA  —  Start-up  error 

Explanation:  Shadow  Recording  cannot  spawn  the  catchup  task,  so 

Shadow  Recording  exits. 

User  Action:  Restart  Shadow  Recording. 

SHA  —  Syntax  error 

Explanation:  The  entered  command  has  incorrect  syntax. 

User  Action:  Reenter  the  command. 

SHA  —  System  error 

Explanation:  A  system  error  occurred. 

User  Action:  Determine  the  effects  of  the  error  if  possible. 

SHA  —  Unknown  command  error 

Explanation:  Shadow  Recording  received  a  command  line  that  it 

could  not  recognize. 

User  Action:  Check  the  command  that  you  entered  or  the  indirect 
command  file. 

SHA  —  Volume  currently  part  of  shadowed  pair 

Explanation:  The  specified  device  is  already  being  shadow 

recorded. 

User  Action:  Check  the  devices  being  shadowed  with  the  DISPLAY 
command. 
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SHA  —  Volume  not  mounted  properly 


Explanation:  The  primary  device  is  not  mounted  Files  11  or  the 

secondary  device  is  not  mounted  foreign. 


User  Action:  Check  the  devices  and  mount  them  properly. 
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SERIAL  DESPOOLER  TASK 


The  Serial  Despooler  Task  (PRT. • • )  provides  a  means  of.  eliminating 
contention  for  the  system  line  printer.  Rather  than  waiting. for  the 
line  printer  to  become  available,  a  task  directs  the  output  intended 
for  the  line  printer  to  a  disk  file.  The  task  issues  a  Send  Data 
directive  to  the  serial  despooler ,  placing  a  data  block  that 
identifies  the  file  to  be  spooled  in  the  serial  despooler  queue. .  A 
Request  directive  is  then  issued  by  the  task  to  activate  the  serial 
despooler  ,  in  case  it  is  not  already  active.  PRT  handles  FCS-created 
files,  but  RMS  files  can  be  read  only  if  they  are  sequential.  All 
files  identified  in  the  serial  despooler  queue  are  printed  in 
first-in-first-out  (FIFO)  order. 

You  may  wish  to  compare  the  capability  of  this  task  with  the  RSX-11M 
Queue  Manager  and  its  associated  despooler.  See  Chapter  7  for  more 
information  about  the  Queue  Manager. 


A . 1  RECEIVE  QUEUE  OPERATION 

The  standard  method  of  placing  a  user  file  in  the  serial  despooler 
receive  queue  (and  requesting  its  execution)  is  via  the  PRINT$  macro 
call,  which  is  described  in  the  IAS/RSX-11  I/O  Operations  Reference 
Manual.  Files  are  spooled  in  this  same  manner  by  the  RSX-11  utilities 
that  support  the  spool  (/SP)  option.  Each  entry  in  the  serial 
despooler  receive  queue  consists  of  a  13-word  data  block  containing 
the  file-related  information  illustrated  in  Figure  A-l. 


A. 2  TEXT  REQUIREMENTS 

The  serial  despooler  task  prints  ASCII  text  with  a  maximum  line  length 
of  132  bytes.  It  will  properly  handle  files  with  all  modes  of  FCS 
carriage  control  (that  is,  standard,  embedded,  and  FORTRAN). 


A. 3  TASK-BUILD  INFORMATION 

The  serial  despooler  task  must  be  built  during  an  RSX— 11M  system 
generation  because  the  task  image  file  (PRT.TSK)  is  not  distributed  on 
the  standard  release  kits.  Normally,  the  serial  despooler  is  built  to 
retain  all  files  that  have  been  spooled,  but  the  serial  despooler 
build  file  can  be  edited  during  system  generation  to  enable  the 
automatic  delete  feature.  (Note  also,  that  a  nondeleting  despooler 
can  be  made  to  delete,  if  the  data  block  mentioned  in  Section  B.l  and 
shown  in  Figure  A-l  has  a  negative  value  in  word  7.)  When  the  serial 
despooler  is  built  without  automatic  delete,  spooled  files  are 
retained  after  printing.  If  the  system  has.  a  deleting  serial 
despooler,  all  spooled  files  are  deleted  after  printing. 
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See  the  System  Generation  and  Management  Guide  for  detailed  system 
generation  information. 


WORD 


1 

File  name 

2 

in 

3 

RADIX-50 

4 

File  type  in  RADIX-50 

5 

File  version  (binary) 

6 

Device  name  in  ASCII 

7 

Unit  number  (binary) 

8 

9 

File  ID 

10 

11 

12 

Directory  ID 

13 

Figure  A-l  PRT  Send  Data  Buffer  Format 


The  serial  despooler  is  set  to  spool  files  to  LPO:.  It  uses  LUN3  as 
the  spool  device.  The  system  manager  can  redirect  print  files  to  any 
record-oriented  device  (that  is,  a  device  similar  to  the  printer)  by 
reassigning  LUN3.  See  the  RSX-11M/M-PLUS  MCR  Operations  Manual  for 
information  on  the  REASSIGN  command. 


A. 4  PRT  ERROR  MESSAGES 

srror  messages  issued  by  PRT  are  sent  to  the  console  terminal  via 
pseudo-device  CO:.  The  error  messages  have  the  following  format: 

PRT  —  text 

In  all  but  the  receive  failure  error,  the  messages  supply  information 
that  identifies  the  sender  task  and  the  file  in  question.  All  PRT 
errors  are  fatal;  upon  error  detection,  printing  of  the  input  file  is 
terminated,  and  a  cleanup/restart  procedure  is  entered. 

In  the  case  of  the  receive  failure  error,  the  sender  and  file 
information  are  unavailable.  Furthermore,  PRT  does  not  attempt  to 
dequeue  additional  spool  requests  because  of  the  nature  of  this  error 
condition.  Instead,  PRT  exits  causing  its  receive  queue  to  be  purged 
by  the  system. 
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RECEIVE  FAILURE,  d.  —  TASK  EXITING 

Explanation:  The  Receive  Data  or  Exit  directive  failed  while 

attempting  to  obtain  the  next  file  specifier  from  the  queue.  The 
system  error  code  (d.)  is  printed  to  identify  the  error. 

NO  DEVICE  NAME  -  SENDER:  task  FILE:  f i lename . typ; ver 

Explanation:  The  dequeued  print  request  did  not  contain  a  device 

name . 

NO  FILE  ID  -  SENDER:  task  FILE:  filename. typ; ver 

Explanation:  The  dequeued  print  request  did  not  contain  a  file 

ID. 


OPEN  FAILURE  INPUT  FILE  -  SENDER:  task  FILE:  filename. typ;ver ,  d. 

Explanation:  The  specified  file  could  not  be  opened.  One  of  the 

following  conditions  may  exist: 

1.  The  file  is  protected  against  access  for  read 

privileges. 

2.  A  problem  exists  on  the  physical  device  (for  example, 
device  cycled  down) . 

3.  The  volume  is  not  mounted. 

4.  The  specified  file  directory  does  not  exist. 

5.  The  named  file  does  not  exist  in  the  specified 
directory. 

6.  The  file  is  already  deleted. 

The  system  error  code  (d.)  is  printed  to  identify  the  failure. 
ATTACH  FAILURE  -  SENDER:  task  FILE:  f ilename . typ; ver ,  d. 
or 

DETACH  FAILURE  -  SENDER:  task  FILE:  filename. typ;ver,  d. 

Explanation:  The  line  printer  could  not  be  attached/detached 

(that  is,  the  system  does  not  contain  a  line  printer).  The 
system  error  code  (d.)  is  printed  to  identify  the  error. 

PRINT  ERROR  -  SENDER:  task  FILE:  f i lename . typ; ver ,  d. 

Explanation:  A  Queue  I/O  request  to  the  line  printer  has  failed. 

The  system  error  code  (d.)  is  printed  to  identify  the  error. 

I/O  ERROR  INPUT  FILE  -  SENDER:  task  FILE:  f i lename . typ; ver ,  d. 

Explanation:  An  error  was  detected  while  reading  the  input  file. 

One  of  the  following  conditions  may  exist: 

1.  A  problem  exists  on  the  physical  device  (for  example, 
device  cycled  down) . 

2.  Length  of  the  text  line  is  greater  than  132  bytes. 

3.  File  is  corrupted  or  the  format  is  incorrect. 

The  system  error  code  (d.)  is  printed  to  identify  the  error. 
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a.  LINES  WERE  TRUNCATED 

Explanation:  While  printing  the  file  PRT  truncated  d 


lines. 
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RSX-1 1M/M-PLUS  UFD  CONVENTIONS 


The  RSX-11M  and  RSX-11M-PLUS  operating  systems  observe  a  set  of  User 
File  Directory  (UFD)  conventions  for  files  on  disk.  These  conventions 
provide  a  consistent  method  of  locating,  allocating,  and  maintaining  a 

file  on  disk. 

A  UFD  is  itself  a  file,  named  in  the  format  gggmmm.DIR  where  g  and  m 
are  octal  numbers  in  the  range  1  through  377  (0  is  reserved) .  The 
numbers  represent  the  file  owner's  group  and  member  number 
respectively.  For  more  information  on  file  ownership  and  directories, 
see  the  RSX-11M/M-PLUS  MCR  Operations  Manual  and  the  RSX-1 1M/M-PLUS 
Command  Language  Manual . 

The  usaqe  of  certain  UFDs  is  common  to  both  operating  systems;  other 
UFDs  are  specific  to  the  RSX-11M  or  RSX-11M-PLUS  operating  systems. 
The  following  sections  describe  group  and  member  numbers  and  their  use 
in  identifying  the  contents  of  system  UFDs.  A  section  on  file  naming 
conventions  is  also  included. 


B.l  GROUP  NUMBER 

The  qroup  number  identifies  groups  of  directories.  By  convention, 
group  numbers  1  through  200  are  reserved  by  DIGITAL  for  system  files 
and  group  numbers  201  through  377  are  reserved  for  user  files.  Th® 
group  numbers  may  vary  between  RSX-11M  and  RSX-11M-PLUS.  Table  B  1 
lists  the  group  numbers  and  their  usage. 


Table  B-l 

Group  Number  Identification 


Group  Number 

Usage 

11 

Executive  files 

12 

MCR  files 

13 

FCP  files  ( RSX-1 1M -PLUS) 

14 

RMD  files 

15 

Privileged  utility  tasks 

23 

DCL  files 

25 

Queue  Manager  files 
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Table  B-l  (Cont.) 

Group  Number  Identification 


Group  Number 

Usage 

27 

On-line  configuration  (RSX-11M-PLUS) 

45 

K-Series  files 

50 

FCS  files 

121 

Line  printer  despooler  (RSX-11M-PLUS) 

125 

Shadow  Recording  (RSX-11M-PLUS) 

126 

Accounting  tasks  (RSX-11M-PLUS) 

200 

SYSGEN  Indirect  command  files 

B. 2  MEMBER  NUMBER 


The  second  number  (member  number)  identifies  the  different  file  types 
within  each  group.  Table  B-2  lists  the  member  numbers. 


Table  B-2 

Member  Number  Identification 


Member  Number 

File  Types 

10 

Source  modules 

20 

Object  modules ,  assembly  and  task-build 
command  files,  and  object  module  libraries 
for  RSX-11M  nonpr ivileged  tasks  and 
RSX-11M/M-PLUS  build  files 

24 

Object  modules,  assembly  and  task-build 
command  files,  and  object  module  libraries 
for  the  RSX-1 1M/M-PLUS  Executive  and  for 
privileged  and  nonpr ivileged  tasks  on 
RSX-1 1M-PLUS 

30 

RSX-11M  unmapped  system  listing  and  map 
files  for  privileged  and  nonpr ivileged 
tasks . 

34 

RSX-11M-PLUS  and  RSX-11M  mapped  system 
listings  and  map  files  for  privileged  and 
nonpr ivileged  tasks . 

40 

SLP  correction  files  for  files  located 
under  member  number  10 

50 

RSX-11M  unmapped  system  image  and  task 
image  files 

(continued  on  next  page) 
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Table  B-2  (Cont.) 

Member  Number  Identification 


Member  Number 

File  Types 

54 

RSX-1 1M -PLUS  and  RSX-11M  mapped  system 

image  and  task  image  files 

60 

RSX-1 IS  unmapped  system  SLP  and  PAT 

correction  files  applied  by  Autopatch,  and 

system  image  and  task  image  files 

64 

RSX-1 IS  mapped  system  image  and  task  image 

files 

200 

SYSGEN  indirect* command  files 

B.3  EXAMPLE  SYSTEM  USER  FILE  DIRECTORIES 


The  system  UFDs  are  composed  of  a  group  number  and  a  member  number. 
These  numbers  identify  the  specific  contents  of  each  directory.  For 
example,  if  you  wanted  to  locate  all  the  MCR  listing  and  map  files, 
you  could  find  the  group  number  for  MCR  files  (12)  and  the  member 
number  for  listing  and  map  files  (34)  and  combine  them  to  specify 


the 


UFD  [12,34];  this  UFD  contains  the  MCR  listing  and  map  files. 
Table  B-3  lists  the  MCR  UFDs  and  the  files  contained  in  each  UFD. 
Table  B-4  lists  the  UFDs  used  by  the  RSX-11M/M-PLUS  operating  system. 


Table  B-3 

MCR  User  File  Directories  (UFDs) 


(12,10] 

MCR  source  files 

[12,20] 

Unmapped  MCR  object  modules,  assembly 

command  files,  and  library  build  command 

file 

[12,24] 

Mapped  MCR  object  modules,  assembly  command 

files,  and  library  build  command  file 

[12,30] 

Unmapped  MCR  listing  and  Map  files 

[12,34] 

Unmapped  MCR  listing  and  map  files 

[12,40] 

SLP  correction  files  for  files  under 

[12,10] 

Table  B-4 
System  UFDS 


[1,1] 

System  and  macro  object  module  libraries 

[1,2] 

System  message  and  help  files 

(continued  on  next  page) 
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Table  B-4  (Cont.) 
System  UFDS 


[1,3] 

Lost  files  found  by  VFY 

[1,4] 

Postmortem  and  snapshot  dumps 

[1,6] 

Error  logging  files  and,  on  RSX-11M-PLUS, 
Accounting 

[1,7] 

Spooling  queue  file  and  transparent  listing 
file 

[1,11] 

RSX-11M-PLUS  work  space  for  system 

maintenance 

[1,20] 

RSX-11M  object  module  libraries  and 
task-build  overlay  descriptor  files  for 
nonpr ivileged  tasks 

[1,24] 

Object  module  libraries,  task-build  command 
files  for  mapped  tasks,  and  overlay 
descriptor  files  for  privileged  tasks 

[1,34] 

Executive  and  task  maps 

[1,54] 

Executive  and  system  tasks 

[2,300] 

UETP  files 

[200,1] 

Sample  files  for  system  introduction 

[200,2] 

Field  service  files 

B.4  SYSTEM  FILE  NAMING  CONVENTIONS 

System  file  names  have  the  following  general  format: 


nnnsss.typ 


where : 

nnn 


is  the  system  identification 
DMP  is  the  identification 
Program. 


for 

for 


the  task, 
the  File 


For  example. 
Dump  Utility 


is  a  suffix  for  noting  the  relationship  of  the  file  to 
the  task  specified  in  the  nnn  identification.  For 
example ,  PIPBLD.CMD  is  the  command  file  for  building  PIP. 

Suffixes : 


typ 


ASM  Assembly  command  file 

BLD  Task  Builder  command  or  overlay  descriptor  file 

RES  FCSRES  version  of  the  task 

FSL  FCSFSL  version  of  the  task  (RSX-11M-PLUS) 


is  the  standard  mnemonic  for 
has  a  set  of  conventional  and 
used  to  reflect  the  contents 


file  type.  RSX-11M/M-PLUS 
default  file  types  that  are 
of  a  file.  See  Table  B-5. 
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Table  B-5 

System  File  Types 

Type 

File  Contents 

.BAS 

BASIC-11  language  source  file 

.BAT 

Batch  file 

.BLD 

Indirect  command  file  used  as  input  to  SYSGEN 

•  B2S 

BASIC-PLUS-2  language  source  file 

.CBL 

COBOL  language  source  file 

•  CDA 

Crash  dump  binary  file 

.  CFS 

Error  logging  control  file  string 

•  CLB 

Indirect  Command  Processor  command  file  library 

•  CMD 

Indirect  command  file 

.COR 

SLP  correction  file 

•  CRF 

Cross-Reference  Processor  symbol  table  file 

.DAT 

File  containing  data  (as  opposed  to  a  program) 

.DIR 

Directory  file 

.  DMP 

File  Dump  Utility  output  file 

.ERR 

Error  Logger  output  file 

•  FTN 

FORTRAN  IV,  FORTRAN  IV-PLUS  or  FORTRAN  77  language 
source  file 

•  HLP 

Help  file 

.LOG 

Batch  or  console  log  file 

•  LST 

Listing  file 

.MAC 

MACRO-11  source  file 

.MAP 

Task  Builder  memory  allocation  map 

.MLB 

Macro  library  file 

.OBJ 

Object  module  (output  from  either  the  MACRO-11 
Assembler  or  a  compiler) 

•  ODL 

Task  Builder  overlay  descriptor  file 

•  OLB 

Object  module  library  file 

.PAT 

PAT  Utility  Correction  file 

.POB 

Patched  object  module  used  by  the  PAT  Utility 

(continued  on  next  page) 
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Table  B-5  (Cont.) 

System  File  Types 

Type 

File  Contents 

.  SML 

System  macro  library  file 

.STB 

Task  symbol  table  file 

•  SYS 

Bootable  system  image  or  other  system  file 

.TMP 

Temporary  file 

•  TSK 

Task  image  file 

•  TXT 

Text  file 

.  ULB 

Universal  library  file 

B-6 


INDEX 


8-bit  character  option,  10-48 


$AB, 

predefined  syntax  element  in 
MML,  12-45 
/ABAUD  keyword, 

SET  command, 

VMR,  10-46 
ABORT  command, 

IOX,  4-23 

Shadow  Recording,  18-7 
Access , 
device , 

disabling,  15-18 
enabling,  15-21 
Account  entry, 

adding  to  account  file,  2-3 
contents,  2-1 
deleting,  2-7 

entering  information  in,  2-3 
examining,  2-4 
listing,  2-6 
modifying,  2-5 
Account  file, 

adding  entry  to,  2-3 
copying,  2-2 
creating,  2-2 
extending,  2-2 
maximum  number  of  entries, 
2-2 

protection,  2-2 
sorting,  2-8 

Account  File  Maintenance 
Program, 

See  ACNT 
ACNT , 

account  file, 
copying,  2-2 
extending,  2-2 
changing  password,  2-2 
copying  account  file,  2-2 
ESCAPE  key,  2-3 
invoking,  2-1 
option , 

Add,  2-3 
create,  2-2 
Delete,  2-7 
Examine,  2-4 
Exit,  2-8 
List,  2-6 
Modify,  2-5 
Sort,  2-8 
protection , 

restoring,  2-2 


AC SUB ,  17-18 
Activity  report, 

IOX,  4-19  to  4-21,  4-41 
Add  option, 

ACNT,  2-3  to  2-4 
Adding  commands, 

DCL,  12-9  to  12-11 
Address , 

CSR , 

changing,  10-12,  15-24 
interrupt  vector, 
changing,  15-24 
vector , 

changing,  10-12 
Address  space, 

MSCP  disks, 

relevant  to  RCT,  5-1 
/AFF  keyword, 

INSTALL  command, 

VMR,  10-21 
SET  command, 

VMR,  10-46 
Alarm, 

sanity  timer, 
enabling,  15-24 
ALARM  option, 

SET  command, 

CON,  15-24 
$ALF , 

predefined  syntax  element  in 
MML,  12-40 

$ALFN, 

predefined  syntax  element  in 
MML,  12-40 

$ALL, 

predefined  syntax  element  in 
MML,  12-43 
ALL  keyword, 

DISPLAY  command, 

CON,  15-10 
OFFLINE  command, 

CON,  15-19 
ONLINE  command, 

CON,  15-21 

Allocate  Device  Transaction 
Block,  17-29 
Allocation  failure, 
pool,  13-2 
ALTER  command, 

VMR,  10-8 

Alternate  CLI,  12-2 
AND  macro, 

MML,  12-25  to  12-26 
ASN  command, 

VMR,  10-9 


Index-1 


INDEX 


ASSIGN  command, 

VMR,  10-9 

command  line  format,  10-9 
example,  10-10 
keyword , 

/GBL,  10-9 

ASSIGN/QUEUE  command, 

DCL,  7-8,  7-12,  7-22 
Assignment , 

logical  device,  10-9 
logical  unit  number, 
changing,  10-32 
displaying,  10-29 
Attribute , 

DCL  syntax  element,  12-25 
ATTRIBUTES  keyword, 

DISPLAY  command, 

CON,  15-10 

Autobaud  detection  option, 
10-46 


$BA, 

predefined  syntax  element  in 
MML,  12-45 

Backup  and  Restore  Utility, 

See  BRU  utility 

Backwards  deletion  option, 
10-48 

Bad  block, 
detection , 

RCT,  5-2 
handling , 

Shadow  Recording,  18-10 
handling  on  MSCP  disks, 

RCT,  5-2 
listing, 

IOX,  4-25 
notification, 

RCT,  5-2 
recovery, 

RCT,  5-1 

removing  from  testing, 

IOX,  4-24 
replacement , 

RCT,  5-1  to  5-2 
replacement  completion , 

RCT,  5-3 
revectoring , 

RCT,  5-3 
specifying , 

IOX,  4-24 
steps  to  replace, 

RCT,  5-2 

Bad  Block  Replacement  Control 
Task , 

See  RCT 


BADB LOCKS, 

display  command,  4-25 
IOX  command,  4-24 
parameter  command,  4-24 
Batch  processing,  7-1,  7-9  to 
7-10 

Batch  processor  prototype 
task,  7-1 
Baud  rate, 

remote  terminal, 
specifying,  10-57 
specifying,  10-59 
BC  macro, 

MML,  12-26 
BCT  macro, 

MML,  12-27  to  12-28 
Block , 
bad , 

detection, 

RCT,  5-2 

handling  on  MSCP  disks, 
RCT,  5-2 
listing , 

IOX,  4-25 
notification, 

RCT,  5-2 
recovery, 

RCT,  5-1 

removing  from  testing, 

IOX,  4-24 
replacement , 

RCT,  5-1  to  5-2 
replacement  completion, 
RCT,  5-3 
revectoring , 

RCT,  5-3 
specifying, 

IOX,  4-24 
steps  to  replace, 

RCT,  5-2 

incomplete  replacement 
checking , 

RCT,  5-1 
logical , 

RCT,  5-1 
replacement , 

RCT,  5-1 

replacement  functions 
listed, 

RCT,  5-1 
$BNUM , 

predefined  syntax  element  in 
MML,  12-40 
/BOOT  keyword, 

SAVE  command, 

VMR,  10-40 
/BOT  keyword, 

SET  command. 
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INDEX 


/BOT  keyword  (Cont.) 

VMR,  10-47 
/BRO  keyword , 

SET  command , 

VMR,  10-48 

Broadcast  option,  10-48 
BRU  utility, 

creating  new  primary  disk, 
B-l  1 

procedure  for  Shadow 
Recording,  18-3 
BS  macro, 

MML ,  12-26 
BST  macro, 

MML,  12-27  to  12-28 
/BUF  keyword, 

SET  command, 

VMR,  10-48 
Buffer  space, 
statistics , 

shown  with  PARAMETERLIST, 
4-42 

BUFFERSIZE  command, 

IOX,  4-26 
BUILD  command, 

CON,  15-7 

command  line  format,  15-7 
example,  15-7 
Bus  run, 
switched , 

connecting,  15-16 
disconnecting ,  15-27 

switching,  15-26 


...CA.,  12-3 
Cache  corruption, 
wr i te-back , 

checking  by  RCT,  5-1 
Cache  data, 
write-back , 

preventing  loss  of,  5-4 
$CALLOV, 

predefined  syntax  element  in 
MML,  12-45 
CAN  command, 

VMR,  10-11 
CANCEL  command, 

VMR,  10-11 

command  line  format,  10-11 
example,  10-11 
Card  Reader  Spooling 

Transaction  Block,  17-33 
Catchall  task,  12-3 
Catchup , 

Shadow  Recording,  18-1 
CBM  macro, 

MML,  12-28 


CCBM  macro, 

MML,  12-28 
Character , 
lowercase , 

converting,  10-51 
Checkpointing, 

dynamic  common  regions,  14—3 
static  common  regions,  14-3 
tasks,  14-3 
/CKP  keyword, 

INSTALL  command, 

VMR,  10-21 
CLEAR  command, 

CON,  15-8 

command  line  format,  15-8 
example,  15-8 
/CLI, 

keyword , 

INSTALL  command, 

VMR,  10-22 

CLI,  11-1,  11~3  to  11-4 

adding  to  account  entry,  2-3 
alternate,  12-2 
changing,  2-5 

contained  in  account  entry, 
2-i 

continuation  lines,  11-8 
displaying,  2-4 
example,  11-10  to  11-20 
FORTRAN,  11-15  to  11-20 
MACRO-11,  11-10  to  11-15 
Executive  directives,  11-3 
installing,  10-22 
interaction  with  system, 

11-3  to  11-4 
MCR,  2-3 

multi-CLI  support,  2-1,  2-3, 
2-5 

prompting,  11-7  to  11-9 
removing,  10-35 
serial  command  processing, 
11-9 

system  messages  to,  11-5  to 
11-7 

task  names,  11-4 
writing,  11-3 
COLOG, 

stopping, 

using  SHUTUP,  8-4,  8-6 
Command , 

DCL, 

adding  to,  12-7,  12-9  to 
12-11 

definition,  12-7,  12-9  to 
12-11 

deleting  from,  12-12 
modifying,  12-12 
tables,  12-6  to  12-12, 
12-17  to  12-20, 
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Command  (Cont.) 

12-46  to  12-47 

line , 

VMR,  10-4 

comment  in,  10-5 

MCR, 

testing  in  UETP,  9-3 
multiple , 

for  Console  Logger,  3-7 
name , 

VMR,  10-4 
parameter , 

VMR,  10-4 
VMR, 

summary,  10-5 
Command  Line  Interpreter, 
See  CLI 
Comment , 

VMR,  10-5 
Common , 

directive, 

fixing,  10-19 
removing,  10-34 
loading,  10-20 
partition,  14-1 
protecting,  10-23 
region, 

fixing,  10-19 
read-only, 

specifying,  10-24 
task , 

sharing,  10-25 
unfixing,  10-74 
COMPAREDATA  YES/NO  command, 
IOX,  4-27 
CON  command, 

VMR,  10-12 
CON  program,  15-1 
command , 

BUILD,  15-7 
CLEAR,  15-8 
DISPLAY,  15-9 
ESTATUS,  15-12 
HELP,  15-14 
IDENT,  15-15 
line,  15-4 
LINK,  15-16 
LIST,  15-17 
OFFLINE,  15-18 
OFFLINE  MEMORY,  15-20 
ONLINE i  15-21 
ONLINE  MEMORY,  15-23 
SET,  15-24 
summary,  15-5 
SWITCH,  15-26 
UNLINK,  15-27 
error  message,  15-36 
invoking , 

indirect  command  file. 


CON  program  (Cont.) 

15-4 

interactively,  15-4 
switch,  15-6 
task-build  time, 
displaying,  15-15 
version  number, 
displaying,  15-15 
Configuration, 

of  devices  in  IOX,  4-28 
system, 
device , 

adding,  15-21 
removing,  15-18 
duplicating,  15-7,  15-17 
information, 

displaying,  15-9 
memory  box, 
adding,  15-23 
removing,  15-20 
CONFIGURATION  command, 

VMR,  10-12 

command  line  format, 
10-12,  10-14 
example,  10-13,  10-15 
keyword , 

CONTROLLERS,  10-12 
CPU,  10-12 
CSR,  10-15 
FULL,  10-12 
UNITS,  10-12 
VEC,  10-15 
CONFIGURE  command, 

IOX,  4-28 
Console , 
driver, 

loading  of,  3-2 
log  assignment, 
displaying,  3-4 
logging, 
command , 

descriptions  of,  3-4 
general  format  of,  3-4 
summary  of,  3-3 
multiple  commands,  3-7 
session , 

example,  3-10 
starting,  3-5 
stopping,  3-5 
output , 

device,  3-1 

active  Console  Logger, 

as  a  pseudo  device,  3-1 
as  affected  by  REDIRECT, 
3-1 

control  of  I/O,  3-1 
determining,  3-8 
MCR  REDIRECT 
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€ 

€ 


Console  (Cont.) 

restriction,  3-9 
redirecting,  3-8 
redirecting  with  MCR 
REDIRECT,  3-9 
status  of,  3-8 
device  I/O, 

controlled  by  Console 
Logger,  3-2 
task,  3-1 

communication  with,  3-2 
installed  by  SYSGEN,  3-2 
selecting  in  SYSGEN,  3-2 
terminal , 

attaching  to,  3-4 
detaching  from,  3-4 
disabling,  3-6 
displaying  assignment,  3-4 
reading  from,  3-4 
reassigning,  3-6 
task  communication  to,  3-3 
writing  to,  3-3 
Console  Logger,  3-1 

aborting  restriction,  3-5 
communication  with,  3-2 
communication  with  a  task, 
3-3 

console  output  device  affect 
on,  3-1 

controlling  I/O  to  CO:,  3-2 
effect  when  active,  3-1 
error  messages  from,  3-13 
Continuation  line, 

CLI,  11-8 
CONTINUE  command. 

Shadow  Recording,  18-8 
Control , 

IOX  command, 
category,  4-3 
RCT  table, 

revector  status  code,  5-1 
Control  and  status  register. 
See  CSR 

CONTROL__C  command, 

IOX, 

effect  on  CTRL/C,  4-31 
CONTROL_C  YES/NO  command, 

IOX,  4-31 
Controller , 
device , 
failure , 

recovering,  15-31 
information , 

displaying,  15-9 
placing , 

off  line,  15-18 
on  line,  15-21 
status  flag, 

displaying,  15-9 


Controller  (Cont.) 
memory  box, 
information, 

displaying,  15-9 
CONTROLLERS  keyword, 

CON  command, 

VMR,  10-12 
DISPLAY  command, 

CON,  15-9 
$COP, 

predefined  syntax  element  in 
MML,  12-43 
COP  macro, 

MML,  12-29 
$COSEP, 

predefined  syntax  element  in 
MML,  12-44 
CPU  keyword, 

CON  command, 

VMR,  10-12 
Crash  reason. 

Resource  Accounting,  17-6 
Create  option, 

ACNT,  2-2 
/CRT  keyword, 

SET  command, 

VMR,  10-48 
$CSEP, 

predefined  syntax  element  in 
MML,  12-44 

CSR, 

address , 

changing,  10-12,  15-24 
option, 

SET  command, 

CON,  15-24 
CSR  keyword, 

CON  command, 

VMR,  10-15 
/CTB  keyword, 

LOAD  command, 

VMR,  10-27 
CTRL/C  command, 

IOX,  4-30 
$CUIC, 

predefined  syntax  element  in 
MML,  12-45 


Date  , 

displaying,  10-72 
setting,  10-72 
$DATE , 

predefined  syntax  element  in 
MML,  12-42 
$DATE1 , 

predefined  syntax  element  in 
MML,  12-42 
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DCL,  7-1,  7-12  to  7-13,  11-2, 
11-5,  11-8,  12-1 
adding  commands,  12-7, 

12-9  to  12-11 
command , 

definition,  12-9 
tables,  12-6,  12-46  to 
12-47 

deleting  commands,  12-12 
installation,  12-1  to  12-3 
mapping  to  MCR,  12-20  to 
12-25,  12-34 
master  command  table, 

12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
modifying  commands,  12-12 
operations,  12-4  to  12-5 
parser  table,  12-6  to  12-12, 
12-17  to  12-20,  12-46  to 
12-47 

SYSGEN,  12-2 
taskbuilding,  12-4 
translator  table,  12-6  to 
12-12,  12-17  to  12-20, 
12-46  to  12-47 

$DDR, 

predefined  syntax  element  in 
MML,  12-43 

Deallocate  Device  Transaction 
Block,  17-30 
DEASSIGN/QUEUE  command, 

DCL,  7-22 
DECnet , 

node  name, 

displayed  by  SHUTUP,  8-2 
UIC, 

specifying,  10-53 
DECnet  Remote  Terminal 
Facility, 

See  RMT 
DECtape , 

exercising , 

IOX,  4-3 
Delete  option, 

ACNT,  2-7 

DELETE/PROCESSOR  command, 

DCL,  7-20  to  7-22 
DELETE/QUEUE  command, 

DCL,  7-19  to  7-20 
/DENS  keyword, 

SAVE  command , 

VMR,  10-40 
Density, 
tape, 

in  IOX,  4-32 
DENSITY  command, 

IOX,  4-32 
DESELECT  command, 

IOX,  4-34 


Despool  prototype  task,  7-1 
Despooler , 

error  message,  A-2 
purpose  of,  A-l 
receive  queue  operation,  A-l 
send  data  buffer  format,  A-2 
system  generation 

information,  A-2 
task-build  information,  A-l 
text  requirements,  A-l 
$DEV, 

predefined  syntax  element  in 
MML,  12-42 
DEV  command, 

VMR,  10-16 
$DEVE , 

predefined  syntax  element  in 
MML,  12-42 
Device, 
access , 

disabling,  15-18 
enabling,  15-21 
adding,  15-21 
buffer  size, 

specifying,  10-48 
context,  15-3 
CSR  address, 

changing,  15-24 
dismounting,  8-4,  8-6 
failed , 

testing,  15-33 
faulty, 

isolating,  15-30 
I/O  request, 

redirecting,  10-33 
information, 

displaying,  10-16 
interrupt  vector  address, 
changing,  15-24 
IOX, 

adding , 

to  be  tested,  4-28 
displaying , 

those  tested,  4-28 
exercising , 
steps,  4-2 
status , 

during  exercise,  4-58 
testing , 

removing,  4-34 
time  of,  4-55 
paging,  10-51 
placing , 

off  line,  15-3,  15-18 
on  line,  15-3 
pseudo , 

console  output,  3-1 
public, 

specifying,  10-57 
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Device  (Cont.) 
removing ,  15-18 
state,  15-2 

marked  for  off-line,  15-3 
marked  for  on-line,  15-3 
off-line,  15-3 
on-line,  15-2 
status , 

emitting,  15-12 
system  default, 

adding  to  account  entry, 

2-3 

changing,  2-5 
contained  in  account 
entry,  2-1 
displaying,  2-4 
uni  t , 

failure , 

recovering,  15-31 
information , 

displaying,  15-9 
placing , 

off  line,  15-18 
on  line,  15-21 
status  flag, 

displaying,  15-9 
write  checking, 

specifying,  10-65 
Device  controller, 
failure , 

recovering,  15-31 
information , 

displaying,  15-9 
placing , 

off  line,  15-18 
on  line,  15-21 
status  flag, 

displaying,  15-9 
Device  driver, 
loading,  10-27 
unloading,  10-75 
Device  name, 
logical , 

assigning,  10-9 
symbolic , 

displaying,  10-16 
Device  Statistics  Block,  17-33 
Device  statistics  example. 
Resource  Accounting,  17-8 
DEVICES  command, 

VMR,  10-16 

command  line  format,  10-16 
example,  10-16 
Diagnostic , 

program,  15-33 
Diagnostic  Loader, 

See  DLD 
Dialog , 

UETP, 


Dialog  (Cont.) 

example,  9-7 

DIGITAL  Command  Language, 

See  DCL 
/DIR  keyword, 

FIX  command, 

VMR,  10-19 
DIR  macro, 

MML,  12-30 
Directive  common, 
fixing,  10-19 
removing,  10-34 
Disk , 

address  space, 

RCT,  5-1 
block , 

random  or  sequential, 

IOX,  4-49 

testing  range  display, 

IOX,  4-50 

testing  range  for  NFS 
volumes , 

IOX,  4-50 

device  exercise  example, 
an  RL02 , 

IOX,  4-9 
NFS  volume, 

IOX,  4-14 
dual-port , 
placing , 

off  line,  15-3,  15-18 
on  line,  15-22 
exercising , 

IOX,  4-2 
Files-11, 

parameter  commands  for, 
IOX,  4-8 
testing  for, 

IOX,  4-63 

I/O  Queue  Optimization, 
specifying,  10-53 
MSCP , 

bad  block  handling, 

RCT,  5-2 
testing, 

selecting  random  testing, 
IOX,  4-49 
skipping  blocks, 

IOX,  4-40 

Dismount  Device  Transaction 
Block,  17-31 
Display, 

IOX, 

bad  blocks  list,  4-25 
commands  as  a  category, 
4-3 

continuing , 

with  PROCEED,  4-48 
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DISPLAY  command, 

CON,  15-9 

command  line  format,  15-9 
example,  15-10 
keyword , 

ALL,  15-10 
ATTRIBUTES,  15-10 
CONTROLLERS,  15-9 
FULL,  15-9 
UNITS,  15-9 
wildcard,  15-10 
Shadow  Recording,  18-9 
DLD,  15-33 

command  line  format,  15-34 
example,  15-35 
DMAP  macro, 

MML,  12-31  to  12-34 
$DNUM , 

predefined  syntax  element  in 
MML,  12-40 
$DONUM , 

predefined  syntax  element  in 
MML,  12-40 
Driver , 
device , 

loading,  10-27 
unloading,  10-75 
$DSB , 

predefined  syntax  element  in 
MML,  12-43 

Dynamic  common  region, 
checkpointing ,  14-3 
shuffling,  14-6 
Dynamic  storage  region, 

See  Pool 


/EBC  keyword, 

SET  command, 

VMR,  10-48 
/ECHO  keyword, 

SET  command, 

VMR,  10-49 
Echo  option,  10-49 
$EDR , 

predefined  syntax  element  in 
MML,  12-44 

$EOL , 

predefined  syntax  element  in 
MML,  12-43 
ERR  macro, 

MML,  12-30 
ERRLOG , 
stopping , 

using  SHUTUP,  8-4,  8-6 
Error , 

hard,  15-29 

recovering,  15-30 


Error  (Cont.) 
intermittent , 

recovering,  15-30 
nonrecover able,  15-29 
recoverable ,  15-29 
soft,  15-29 
transient , 

recovering,  15-30 
uncorrectable , 

recovering,  15-32 
Error  limit, 
altering , 

IOX,  4-35 


Error  Logger, 

relationship  to  RCT, 
Error  message. 

See  also  Message 
CON,  15-36 

Console  Logger,  3-13 
despooler,  A-2 
HRC ,  15-38 
IOX,  4-66 
RMD,  6-13 
UETP,  9-5 
VMR,  10-76 
Error  report, 
data  compare, 

IOX,  4-21 

directing  to  device, 
IOX,  4-41 
d isabl ing , 

IOX,  4-52 
enabling , 

IOX,  4-52 
I/O  error, 

IOX,  4-21 
types. 


5-4 


IOX, 

UETP, 


4-52 

9-4 


Error  sequence  number, 
use  of,  6-12 
ERRORLIMIT  command, 

IOX,  4-35 
$ESB , 

predefined  syntax  element 
MML,  12-43 
ESCAPE  key, 

requesting  list  of  options 
ACNT,  2-3 

Esc ape- sequence  recognition 
option,  10-49 
/ESCSEQ  keyword, 

SET  command, 

VMR,  10-49 
ESTATUS  command, 

CON,  15-12 


m 


9 


example. 
Event , 
pool , 


15-13 
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Event  (Cont.) 

affecting  pool  condition, 
13-3 

detecting,  13-1 
extreme  fragmentation , 

13-1  to  13-4,  13-7  to 
13-10,  13-12 
general  fragmentation, 
13-2  to  13-4 
major,  13-1  to  13-3 
Event  flag, 

use  in  IOX,  4-64 
Examine  option, 

ACNT,  2-4  to  2-5 
EXECUTE  command, 

IOX,  4-36 
Execution , 

termination, 
of  task, 

IOX,  4-23 
Execution  mode, 
entering , 

IOX,  4-59 
IOX,  4-18 
Executive , 
module , 

CORAL. MAC,  13-2  to  13-3 
pool  monitor, 

code,  13-1,  13-12 
interface,  13-2  to  13-3 
swapping , 
length , 

specifying,  10-61 
priority  range, 

specifying,  10-61 
Exercise , 

NFS  volume, 
with  VERIFY, 

IOX,  4-14 
with  VERIFY, 

IOX,  4-14 
EXIT  command, 

IOX,  4-37 
Exit  option, 

ACNT,  2-8 
External  header, 
task, 

specifying,  10-25 


Failure , 
hardware , 

recovering,  15-30 
intermittent ,  15-29 
media,  15-28 
memory, 

power  loss,  15-32 

uncor rectable  error,  15-32 


Failure  (Cont.) 
memory  box, 

recovering,  15-31 
processor , 

recovering,  15-31 
transient,  15-28 
Fairness  count, 
adjustment,  16-3 
Fault, 

hardware,  15-28 
system,  15-28 

diagnosing,  15-30 
recovering,  15-30 
/FDX  keyword, 

SET  command, 

VMR,  10-49 
$FIL, 

predefined  syntax  element  in 
MML,  12-41 

File, 

See  also  Account  file 
specifying , 

VMR,  10-3 

symbol  definition,  10-2 
overriding,  10-4 
system  image, 

configuring,  10-1 
Executive  data  space  and, 
10-2 

$FILE , 

predefined  syntax  element  in 
MML,  12-41 
File  size, 
in  blocks, 

specifying,  4-61 
File-structured  device, 
exercising , 

IOX,  4-3 
Files-11, 
disk , 

selecting  for  testing, 

IOX,  4-38 
disk  structure, 
testing  for  a, 

IOX,  4-63 
volume , 

protecting  with 

TEMPORARYFILE, 

IOX,  4-61 
volume  exercise, 
example  of, 

IOX,  4-9 

FILES 11  command, 

IOX, 

default  parameters,  4-38 
Fill  characters  option,  10-50 
vertical,  10-64 
FIX  command, 

VMR,  10-18 
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/FIX  keyword , 

INSTALL  command, 

VMR,  10-22 

FIX-IN-MEMORY  command, 

VMR,  10-18 

command  line  format,  10-18 
example,  10-19 
keyword , 

/DIR,  10-19 
/NSF,  10-19 
/REG,  10-19 
/RON,  10-19 

Flag, 
status , 
device , 

displaying,  15-9 
list,  15-9 

Flying  installs,  12-3 
$FNAM , 

predefined  syntax  element  in 
MML,  12-44 
/FO  keyword, 

QUE  /SP  command, 

MCR,  7-17 
Form  feed, 
hardware , 

specifying,  10-50 
/FORMFEED  keyword, 

SET  command, 

VMR,  10-50 
/FORMS  qualifier, 

INITIALIZE/PROCESSOR 
command , 

DCL,  7-17 
Fragment , 

pool,  13-2  to  13-5,  13-13 
Fragmentation, 

pool,  13-1  to  13-5,  13-7  to 
13-10,  13-12  to  13-13 
FREE  command, 

RMD,  6-8 
$FSEP, 

predefined  syntax  element  in 
MML,  12-44 
FULL  keyword, 

CON  command, 

VMR,  10-12 
DISPLAY  command, 

CON,  15-9 

Full-duplex  option,  10-49 
Function  commands , 

IOX, 

as  a  category,  4-3 


/GBL  keyword, 
ASSIGN  command, 
VMR,  10-9 


Group  Number  Identification, 
definition,  B-l 


Hardware , 
failure , 

recovering,  15-30 
fault,  15-28 
form  feed  option,  10-50 
horizontal  tab  option,  10-50 
/HE  switch, 

CON,  15-6 
Header , 
task , 

display  in  RMD,  6-10 

altering  from  MCR,  6-11 
external , 

specifying,  10-25 
HELP  command, 

CON,  15-14 

command  line  format,  15-14 
example,  15-14 
IOX,  4-39 
/HFILL  keyword, 

SET  command, 

VMR,  10-50 
/HHT  keyword, 

SET  command, 

VMR,  10-50 
HLP  macro, 

MML,  12-31 
HRC ,  15-2 

error  message,  15-38 
task-build  time, 
displaying,  15-15 
version  number, 
displaying,  15-15 


I/O  error  report, 

IOX,  4-21 
I/O  exercise, 
steps,  4-2 
termination,  4-23 
I/O  page, 

overmapping ,  10-22 
I/O  Queue  Optimization,  16-1 
Cylinder  Scan,  16-1,  16-4 
Elevator,  16-1,  16-4 
Fairnesscount ,  16-2 
initiating,  16-1 
messages,  16-4 

Nearest  Cylinder,  16-1,  16-3 
optimization  types,  16-3 
specifying,  10-53 
valid  device,  10-53 
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I/O  request, 

redirecting,  10-33 
IDENT  command, 

CON,  15-15 

command  line  format,  15-15 
example,  15-15 
$IFIL, 

predefined  syntax  element  in 
MML,  12-41 
$IFILE, 

predefined  syntax  element  in 
MML,  12-41 

IFORM,  12-20  to  12-25 
/IM  switch, 

VMR,  10-4,  10-41 
/INC  keyword, 

INSTALL  command, 

VMR,  10-22 

Indirect  command  file, 

CON,  15-4 
IOX,  4-6 
VMR,  10-3 

INITIALIZE/PRINTER  command, 
DCL,  7-6 

INITIALIZE/PROCESSOR  command, 
DCL,  7-14  to  7-19 

/FORMS  qualifier,  7-17 
INITIALIZE/QUEUE  command, 

DCL,  7-4,  7-11,  7-13 
INSTALL  command, 

VMR,  10-20 

command  line  format,  10-20 
example,  10-26 
keyword , 

/AFF,  10-21 
/CKP,  10-21 
/CLI,  10-22 
/FIX,  10-22 
/INC,  10-22 
/IOP,  10-22 
/PAR,  10-22 
/PMD,  10-23 
/PRI,  10-23 
/PRO,  10-23 
/RON,  10-24 
/ROPAR,  10-24 
/SEC,  10-24 
/SLV,  10-24 
/SYNC,  10-25 
/TASK,  10-25 
/UIC,  10-25 
/XHR,  10-25 
Installation, 

DCL,  12-1 
flying,  12-3 
Installing , 

DCL,  12-3 
Interactive  mode, 

IOX,  4-18 


INTERLEAVE  command, 

IOX,  4-40 

Intermediate  form, 

DCL, 

IFORM, 

Interrupt  vector  address, 
changing,  15-24 

Interval  report, 

IOX,  4-20 

Invalid  Login  Transaction 
Block,  17-29 

/IOP  keyword, 

INSTALL  command, 

VMR,  10-22 

IOX, 

command , 

ABORT,  4-23 
BADBLOCKS,  4-24 
BUFFERSIZE,  4-26 
categories,  4-3 
COMPAREDATA  YES/NO,  4-27 
CONFIGURE,  4-28 
CONTROL_C  YES/NO,  4-31 
CTRL/C,  4-30 
DENSITY,  4-32 
description,  4-22 
descriptions,  4-22 
DESELECT,  4-34 
ERRORLIMIT,  4-35 
EXECUTE,  4-36 
EXIT,  4-37 
files,  4-6 
FILES11 ,  4-38 
HELP,  4-39 

in  interactive  mode,  4-19 
INTERLEAVE,  4-40 
LOGFILE,  4-41 
mode,  4-18 
parameter , 

by  device  type,  4-9 
with  FILES11 ,  4-8 
with  SELECT,  4-8 
with  VERIFY,  4-9 
parameter  list, 
for  Files-11,  4-8 
for  NFS  volumes,  4-8 
PARAMETERLIST,  4-42 
PATTERN,  4-46 
PRINTSUMMARY,  4-47 
PROCEED,  4-48 
RANDOM,  4-49 
RANGE,  4-50 
RECORDS,  4-51 
REPORTERRORS  YES/NO,  4-52 
RESTART,  4-53 
RETRIES,  4-54 
RUNTIME,  4-55 
SELECT,  4-56 
SPY,  4-58 
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IOX  (Cont.) 

START,  4-59 

summary  with  HELP,  4-39 
SUMMARYTIME,  4-60 
syntax,  4-22 
TEMPORARYFILE,  4-61 
VERIFY,  4-62 
VOLUMECHECK,  4-63 
WAIT,  4-64 
WRITECHECK,  4-65 
considerations  for,  4-1 
controlling  with  CTRL/C, 

4-30 
data , 

compare  error  report,  4-21 
pattern  checking,  4-27 
transfer  size  of,  4-26 
DECtape  exercising,  4-3 
defaults , 

changing  during  task 
build,  4-22 
device , 

exercising  steps,  4-2 
status  display,  4-58 
testing , 

time  of,  4-55 
disk  exercising,  4-2 
error  message,  4-66 
execution  mode,  4-18 
entering,  4-18 
exercise  parameters , 
list  of  general,  4-8 
exiting  from,  4-37 
file-structured  exercising , 
4-3 

increment,  4-5 
indirect  command  files,  4-6 
installation, 
on  RSX-11M,  4-4 
on  RSX-1 1M-PLUS ,  4-4 
interleaving  with  Executive, 
4-64 

interval  report  output 
frequency,  4-60 
invoking , 

on  RSX-1 1M ,  4-5 
on  RSX-1 1M-PLUS ,  4-5 
when  installed,  4-5 
when  not  installed,  4-5 
with  an  increment,  4-5 
without  an  increment,  4-5 
nonfile-structured 
exercising,  4-3 
output  type, 

activity  report,  4-19 
interval  report,  4-20 
summary  report,  4-20 
parameter , 

command  exercising 


IOX  (Cont.) 

magnetic  tape,  4-11 
default  overriding  with 
FILES11 ,  4-38 
default  overriding  with 
SELECT,  4-56 
default  shown  with 

PARAMETERLIST,  4-42 
device-dependent  exercise, 
4-8 

exercising  Files- 11 
volumes,  4-9 
exercising  NFS  volume, 

4-14 

list  of  general  exercise, 
4-8 

parameter  command, 
category,  4-3 
pattern, 

altering  test,  4-46 
displaying  test,  4-46 
restarting,  4-53 
RSX-1 1M , 

running  from,  4-36 
running  steps,  4-2 
selecting , 
devices,  4-7 
Files-11  volume,  4-7 
NFS  volume,  4-7,  4-62 
NFS  volume  with  VERIFY, 

4-7 

starting,  4-59 
tape  exercising,  4-2 
task  termination,  4-18 
task-build  file, 
location  of,  4-22 
termination,  4-37 
using  PROCEED,  4-48 
test  configuration,  4-28 
adding  units,  4-6 
displaying,  4-7 
setting  up,  4-6 
testing , 

removing  devices  from, 

4-34 

wai t-for-event  flag,  4-64 
write-check,  4-65 


$JSR , 

predefined  syntax  element  in 
MML,  12-45 


Keyword , 
VMR,  10-4 
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Library, 

UIC, 

specifying,  10-50 
/LIBUIC  keyword, 

SET  command, 

VMR,  10-50 
LINE  FEED  key, 

generating  task  list, 

PMT,  13-8 
/LINES  keyword, 

SET  command, 

VMR,  10-51 
LINK  command, 

CON,  15-16 

command  line  format,  15-16 
example,  15-16 
LIST  command, 

CON,  15-17 

command  line  format,  15-17 
example,  15-17 
List  option, 

ACNT,  2-6  to  2-7 
$LOAD, 

predefined  syntax  element  in 
MML ,  12-45 
LOAD  command, 

VMR,  10-27 

command  line  format,  10-27 
example,  10-28 
keyword , 

/ CTB ,  10-27 
/PAR,  10-27 
/SIZE,  10-27 
Load  test, 

UETP,  9-2 
Log  file, 

disabling,  3-6 
example  of  a,  3-9 
reading  the,  3-9 
reassigning,  3-7 
task  communication  to,  3-3 
use  of  log  file  defaults, 

3-7 

using  PIP  to  read  the,  3-9 
LOGFILE  YES/NO  command, 

IOX,  4-41 
Logging , 

console  output,  3-1 
messages , 

Console  Logger,  3-2 
Logical  block, 

RCT,  5-1 
Logical  name, 
assigning,  10-9 
Logical  unit  number, 

See  LUN 

LOGICAL  UNIT  NUMBERS  command, 
VMR,  10-29 


Login, 

disabling,  10-51 
enabling,  10-51 

Login  Transaction  Block,  17-32 
/LOGON  keyword, 

SET  command, 

VMR,  10-51 
/LOWER  keyword, 

SET  command, 

VMR,  10-51 
Lowercase  character, 
converting,  10-51 
$LUIC , 

predefined  syntax  element  in 
MML,  12-45 

LUN, 

assignment , 

changing,  10-32 
displaying,  10-29 
LUN  command, 

VMR,  10-29 

command  line  format,  10-29 
example,  10-29 


Macro  Meta Language , 

See  MML 
Magnetic  tape, 
density, 

displaying  in  IOX,  4-32 
specifying  in  IOX,  4-32 
exercise , 

example,  4-11 
using  SELECT,  4-11 
exercising , 
in  IOX,  4-2 
records  tested,  4-51 
retries  upon  error,  4-54 
testing , 

altering  record  count, 

4-51 

/MAIN  keyword, 

SET  command, 

VMR,  10-51 
MAP  macro, 

MML,  12-31  to  12-34 
Mapping , 

DCL  to  MCR,  12-20  to  12-25, 
12-34 

Master  command  table, 

DCL,  12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
/MAXEXT  keyword, 

SET  command, 

VMR,  10-53 

MCR,  7-1,  7-12  to  7-13, 

11-1  to  11-2,  11-5,  12-1, 
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MCR  (Cont.) 

12-20  to  1 2-2 5 ,  12-34 
CLI  default,  2-3 
command , 

testing  in  UETP,  9-3 
mapping  to  DCL,  12-20  to 
12-25,  12-34 

relationship  with  VMR,  10-1 
Media , 

failure,  15-28 

Member  Number  Identification, 
definition,  B-2 
Memory, 
box , 

adding,  15-23 
failure , 

recovering,  15-31 
information, 

displaying,  15-9 
removing,  15-20 
compacting  space. 

See  SHF 
display, 

See  RMD 

failure,  15-31 
maximum  size  of,  10-41 
Message , 
error , 

CON,  15-36 
HRC ,  15-38 
recording , 

by  Console  Logger,  3-2 
size  for  console  output,  3-3 
time-stamping , 

by  Console  Logger,  3-2 
VMR,  10-76 
Metalanguage ,  12-12 
general  description, 

12-13  to  12-15 
MML,  12-5  to  12-6,  12-9, 

12-15  to  12-17 
AND  macro,  12-25  to  12-26 
BC  macro,  12-26 
BCT  macro ,  12-27 
BS  macro,  12-26 
BST  macro,  12-27  to  12-28 
CBM  macro,  12-28 
CCBM  macro ,  12-28 
COP  macro,  12-29 
DIR  macro,  12-30 
DMAP  macro,  12-31  to  12-34 
ERR  macro,  12-30 
HLP  macro,  12-31 
MAP  macro,  12-31  to  12-34 
NO  macro,  12-35 
OCOP  macro,  12-29 
OPT  macro,  12-35  to  12-36 
OPTR  macro,  12-35  to  12-36 
predefined  syntax  elements. 


MML  (Cont.) 

12-39  to  12-45 
PRO  macro,  12-36  to  12-37 
QUA  macro,  12-37  to  12-38 
TST  macro,  12-39 
Modify  option, 

ACNT,  2-5  to  2-6 
Modifying , 
commands , 

DCL,  12-12 

Monitor  Console  Routine, 

See  MCR 

Mount  Device  Transaction 
Block,  17-30 
MOUNT/FOREIGN  command. 
Shadow  Recording,  18-3 
MSCP  disk, 

RCT, 

address  space,  5-1 
bad  block  handling,  5-2 


/NETUIC  keyword, 

SET  command, 

VMR,  10-53 
$NEW , 

predefined  syntax  element  in 
MML,  12-44 

$NFIL, 

predefined  syntax  element  in 
MML,  12-41 
$NFILE , 

predefined  syntax  element  in 
MML,  12-41 

NFS, 

exercise , 

example  of,  4-14 
testing , 

range  of  blocks,  4-50 
volume , 

altering  range  of  test 
blocks,  4-50 

displaying  range  of  test 
blocks,  4-50 
error  retries,  4-54 
selecting  with  SELECT, 

4-56 

selecting  with  VERIFY, 

4-62 

NO  macro, 

MML,  12-35 
$NOD, 

predefined  syntax  element  in 
MML,  12-41 

$NODE , 

predefined  syntax  element  in 
MML,  12-41 
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/NOMSG  switch, 

CON,  15-6 

Nonfile- structured  exercising , 
IOX,  4-3 
/NSF  keyword, 

FIX  command, 

VMR,  10-19 
$NULL , 

predefined  syntax  element  in 
MML ,  12-45 

$NUM , 

predefined  syntax  element  in 
MML,  12-39 


OCOP  macro, 

MML,  12-29 
$ODEV , 

predefined  syntax  element  in 
MML,  12-42 
$ODEVE , 

predefined  syntax  element  in 
MML,  12-42 
OFFLINE  command, 

CON,  15-18 

command  line  format,  15-19 
example,  15-19 
keyword , 

ALL,  15-19 

OFFLINE  MEMORY  command, 

CON,  15-20 

command  line  format,  15-20 
example,  15-20 
ONLINE  command, 

CON,  15-21 

command  line  format,  15-21 
example,  15-22 
keyword , 

ALL,  15-21 

ONLINE  MEMORY  command, 

CON,  15-23 

command  line  format,  15-23 
example,  15-23 
$0NUM , 

predefined  syntax  element  in 
MML,  12-40 
/OPT  keyword, 

SET  command, 

VMR,  10-53 
OPT  macro, 

MML,  12-35  to  12-36 
OPTR  macro, 

MML,  12-35  to  12-36 
$OSEP, 

predefined  syntax  element  in 
MML,  12-44 

$OUIC, 

predefined  syntax  element  in 
MML ,  12-42 


$OUICE , 

predefined  syntax  element  in 
MML,  12-42 
OWNER  command, 

RMD,  6-9 


Page, 

display, 

RMD,  6-1 
Paper  tape, 

saving  system  on,  10-40  to 
10-41 

PAR  command, 

VMR,  10-30 

command  line  format,  10-30 
example,  10-30 
/PAR  keyword, 

INSTALL  command, 

VMR,  10-22 
LOAD  command, 

VMR,  10-27 
SET  command, 

VMR,  10-54 
Parameter , 

IOX, 

command  category,  4-3 
default  overriding  with 
FILES 1 1 ,  4-38 
default  overriding  with 
SELECT,  4-56 
default  shown  with 

PARAMETERLIST,  4-42 
device-dependent  exercise, 
4-8 

exercising  Files- 11 
volumes,  4-9 

exercising  magnetic  tape, 
4-11 

exercising  NFS  volume, 

4-14 

list  of  general  exercise, 
4-8 

PARAMETERLIST  command, 

IOX,  4-42 

displaying  buffer  space, 
4-42 

displaying  defaults,  4-42 
Parser  table, 

DCL,  12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
Partition, 

common,  14-1 
CPU,  10-54 

creating,  10-51,  10-54 
device,  10-51,  10-54 
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Partition  (Cont.) 

eliminating,  10-52,  10-54 
fragmentation,  14-3 
information, 

displaying,  10-30 
main,  10-51,  10-54 
pool,  10-54 
sections , 
size , 

specifying,  10-51,  10-54 
system-controlled ,  14-1 
boundary, 

moving,  10-47,  10-63 
type,  10-51,  10-54 
user-controlled ,  14-1 
PARTITION  DEFINITIONS  command, 
VMR,  10-30 
Password , 

adding  to  account  entry,  2-3 
changing,  2-2,  2-5 
characters,  2-3 
contained  in  account  entry, 
2-1 

displaying,  2-4 
Pattern, 

IOX, 

altering  test,  4-46 
displaying  test,  4-46 
PATTERN  command, 

IOX,  4-46 

Peripheral  Interchange 
Program, 

See  PIP  utility 
PIP  utility, 
account  file, 
copying,  2-2 
extending,  2-2 
/PLCTL  keyword, 

SET  command, 

VMR,  10-55 

PMD, 

requesting,  10-23 
/PMD  keyword, 

INSTALL  command, 

VMR,  10-23 

PMT, 

aborting,  13-12 

tasks,  13-7  to  13-9, 

13-11  to  13-12 
assembling,  13-1 
checkpointing,  13-5,  13-11 
internal  cycle  interval, 
13-5,  13-11 
LINE  FEED  key,  13-8 
message  to  console, 

extreme  fragmentation , 

13-7 

low  pool  state,  13-6 
message  to  terminals. 


PMT  (Cont.) 

cycle  interval,  13-6 
extreme  fragmentation , 

13-7 

low  pool  state,  13-6, 

13-11 

modifying,  13-11  to  13-12 
overview,  13-3 
PMTBLD.CMD,  13-10  to  13-12 
pool  use  controls,  13-5, 
13-12 

preventing , 

invocation  of  TKTN,  13-7 
tasks  from  executing,  13-7 
response , 

extreme  fragmentation, 
13-1,  13-3  to  13-4, 
13-7  to  13-10,  13-12 
general  fragmentation, 

13-3  to  13-4 
pool  condition,  13-1, 

13-3  to  13-4 

pool  state,  13-3  to  13-5 
RETURN  key,  13-8 
stopping,  13-5 
Task  Builder  options,  13-10 
task-building ,  13-1 
unstopping,  13-5 
PMTBLD.CMD,  13-10  to  13-12 
Pool , 

allocation  failure,  13-2 
condition. 

Executive  response,  13-1, 
13-4 

fluctuation,  13-4 
high,  13-4 
low,  13-4 

PMT  response,  13-1, 

13-3  to  13-4 
relationship  to  pool 
limit,  13-2 
controls, 

PMT,  13-5,  13-12 
event,  13-1 

fragment,  13-2  to  13-5, 

13-13 

fragmentation ,  13-9 

affecting  pool  state,  13-3 
extreme,  13-1  to  13-4, 

13-7  to  13-10,  13-12 
general,  13-2  to  13-4 
reducing,  13-13 
free,  13-2 
limit , 

See  also  SET,  /PLCTL 
relationship  to  pool 

condition,  13-2,  13-4 
monitor  code. 

See  Executive 
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Pool  (Cont.) 

monitor  interface , 

See  Executive 
monitoring,  13-1 
parameters , 

setting,  10-55 
secondary, 

installing  task  in,  10-2*4 
use , 

displaying,  10-59 
SET  /PLCTL  command,  13-2, 
13-12  to  13-13 
si  ze , 

displaying,  10-56  to  10-57 
increasing,  10-56 
specifying,  10-57 
state , 

affected , 

by  pool  condition,  13-3 
by  pool  fragmentation, 
13-3 

high,  13-11,  13-13 
low,  13-11,  13-13 
overriding  Executive 
notification,  13-5 
PMT  response,  13-3  to  13-4 
system  transition,  13-4 
/POOL  keyword, 

SET  command, 

VMR,  10-56 
Pool  Monitor  Task, 

See  PMT 

/POOLSIZE  keyword, 

SET  command, 

VMR,  10-57 
Postmortem  Dump, 

See  PMD 
Power , 
loss , 

recovering,  15-32 
Predefined  syntax  element, 

MML,  12-40 

Predefined  syntax  elements, 
MML,  12-39,  12-41  to  12-45 
/PRI  keyword, 

ALTER  command, 

VMR,  10-8 
INSTALL  command, 

VMR,  10-23 

Primary  disk  errors,  18-10 
Print  Despooler  Transaction 
Block,  17-32 
PRINTSUMMARY  command, 

IOX,  4-47 
/PRIV  keyword, 

SET  command, 

VMR,  10-57 
Privilege, 
terminal , 


Privilege  (Cont.) 

specifying,  10-57 
/PRO  keyword, 

INSTALL  command, 

VMR,  10-23 
PRO  macro, 

MML,  12-36  to  12-37 
$PROC , 

predefined  syntax  element  in 
MML,  12-44 
PROCEED  command, 

IOX,  4-48 
Processor , 
failure , 

recovering,  15-31 
halting,  8-4,  8-6 
information, 

displaying,  15-9 
placing , 

on  line,  15-21 
Prompting , 

CLI,  11-7  to  11-9 
$PRONC , 

predefined  syntax  element  in 
MML,  12-44 
Protection , 
file,  2-2 
Prototype  task, 

batch  processor,  7-1 
despool,  7-1 
PRT. . . ,  7-7 
/PUB  keyword, 

SET  command, 

VMR,  10-57 


QMG,  7-1 
stopping , 

using  SHUTUP,  8-4,  8-6 
QMGCLI ,  7-1  to  7-2 
$QTRAN,  17-18 
$QTRAN1 ,  17-19 
$QTRAN2 ,  17-20 
QUA  macro , 

MML,  12-37  to  12-38 
QUE  /AS  command, 

MCR,  7-8,  7-12,  7-22 
QUE  /CR  command, 

MCR,  7-4,  7-11,  7-13 
QUE  /DEA  command, 

MCR,  7-22 
QUE  /DEL  command, 

MCR,  7-19 

QUE  /DEL: Q  command, 

MCR,  7-20 
QUE  /KIL  command, 

MCR,  7-25 
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QUE  /SP  command , 

MCR*,  7-6,  7-13  to  7-17,  7-19 
/FO  keyword,  7-17 
QUE  /STA  command, 

MCR,  7-26  to  7-31 
QUE  /STA : QMG  command, 

MCR,  7-3,  7-26  to  7-27 
QUE  /STO  command, 

MCR,  7-23  to  7-25 
QUE  /STO: QMG  command, 

MCR,  7-23 

QUE  /STO: QUE  command, 

MCR,  7-23 
QUE  /UNSP  command, 

MCR,  7-20  to  7-22 
Queue  Manager, 

See  QMG 


$R50 , 

predefined  syntax  element  in 
MML ,  12-41 
RANDOM  command, 

IOX,  4-49 
RANGE  command, 

IOX,  4-50 
RATE  command, 

RMD,  6-8  to  6-9,  6-11 
RCT,  5-1 
bad  block, 

detection,  5-2 
notification,  5-2 
replacement,  5-2 
replacement  completion, 

5-3 

revectoring,  5-3 
installing,  5-1 
logical  block,  5-1 
recovery  techniques  for 
disks,  5-1 
relationship, 

Error  Logger,  5-4 
RSX-11M  utilities,  5-4 
replacement  block,  5-1 
primary,  5-3 
secondary,  5-3 
RD:,  15-2 
REA  command, 

VMR,  10-32 
Read , 

from  console  terminal,  3-4 
nondestructive , 

NFS  volumes,  4-62 
Read-pass-all  option,  10-58 
REASSIGN  command, 

VMR,  10-32 

command  line  format,  10-32 


REASSIGN  command  (Cont.) 

example,  10-32 
Reconfiguration, 
service,  15-1 

command  interface,  15-1 
driver,  15-2 
initiating,  15-4 
task,  15-2 
system,  15-1 
RECORDS  command, 

IOX,  4-51 

Recovery  techniques, 

RCT, 

for  disks,  5-1 
RED  command, 

VMR,  10-33 
REDIRECT  command, 

VMR,  10-33 

command  line  format,  10-33 
example,  10-33 
/REG  keyword, 

FIX  command, 

VMR,  10-19 
REMOVE  command, 

VMR,  10-34 
UNFIX  command, 

VMR,  10-74 
Region, 
common, 

fixing,  10-19 
read-only, 

specifying,  10-24 
task , 

sharing,  10-25 
unfixing,  10-74 
fixing,  10-18 

restrictions,  10-18 
loading , 

restrictions,  10-18 
removing,  10-34 
REM  command, 

VMR,  10-34 
/REMOTE  keywo rd , 

SET  command, 

VMR,  10-57 
REMOVE  command, 

VMR,  10-34 

command  line  format,  10-34 
example,  10-34 
keyword , 

/REG,  10-34 
Replacement  block , 

RCT,  5-1 

primary,  5-3 
secondary,  5-3 
Report , 

interval , 

output  frequency,  4-60 
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REPORTERRORS  YES/NO  command, 
IOX,  4-52 
$RESET, 

predefined  syntax  element  in 
MML ,  12-44 

Resource  Accounting,  17-1 
See  also  Transaction  file 
commands,  17-4 

SET  ACCOUNTING,  17-4, 

17-10 

SHOW  ACCOUNT I NG/- 

DATATRIEVE ,  17-4, 

17-18 

SHOW  ACCOUNT ING/- 

INFORMATION ,  17-4, 
17-12 

SHOW  ACCOUNTING/- 

TRANSACTION_F ILE , 

17-4,  17-13  \ 

START/ ACCOUNTING,  17-4  to 
17-5 

STOP/ACCOUNTING,  17-4, 
17-11 

crash  reason,  17-6 
device  statistics  example, 
-17-8 

interface  for  creating 
transactions , 

$QTRAN,  17-18 
$QTRAN1 ,  17-19 
$QTRAN2 ,  17-20 
messages,  17-42 
privileged  task  interface, 
17-22 

scan  rate,  17-6 
secondary  pool,  17-5 
statistics  scan,  17-6 
stopping , 

using  SHUTUP,  8-6 
system  resources,  17-41 
system  statistics,  17-5 
task  accounting,  17-7 
using  DATATRIEVE-1 1  for  an 
accounting  report,  17-17 
Resource  Monitoring  Display, 
See  RMD 

RESTART  command, 

IOX,  4-53 
RETRIES  command, 

IOX,  4-54 
RETURN  key, 
exiting , 

PMT,  13-8 

Revector  control  table, 

RCT, 

status  codes,  5-1 
RL02  exercise, 

IOX,  4-9 


RMD,  14-5 
altering , 

active  task  display  from 
MCR,  6-9 

display  from  setup  page, 
6-7 

memory  display,  6-8 
from  MCR,  6-8 
task  display,  6-10 
from  setup  page,  6-9 
command  line, 
to  install,  6-2 
to  invoke,  6-2 
display  page,  6-1 
displaying , 

active  task,  6-8 
commands  to  alter  task, 
6-11 

error  sequence  number, 

6-12 

help,  6-3 
memory,  6-4 

RSX-1 1M-PLUS  only,  6-11 
system  statistics,  6-12 
task  header,  6-10 
task  header  list  of  items, 
6-10 

error  message,  6-13 
FREE  command,  6-8 
installing,  6-2 

individual  terminal,  6-2 
introduction  to,  6-1 
invoking,  6-2 

at  terminal,  6-2 
OWNER  command,  6-9 
RATE  command,  6-8  to  6-9, 
6-11 
running , 

on  slaved  terminal,  6-2 
setup  page,  6-1,  6-7 
TASK  command,  6-9,  6-11 
task  header  display, 

altering  from  MCR,  6-11 
task-build  command  file, 
modifying,  6-12 
using , 

individual  terminal,  6-2 
RMT,  11-2 
/RNDC  keyword, 

SET  command, 

VMR,  10-58 
/RNDH  keyword, 

SET  command, 

VMR,  10-58 
/RNDL  keyword, 

SET  command, 

VMR,  10-58 
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/RON  keyword, 

FIX  command, 

VMR,  10-19 
INSTALL  command, 

VMR,  10-24 
UNFIX  command, 

VMR,  10-74 
/ROPAR  keyword, 

INSTALL  command, 

VMR,  10-24 

Round-robin  schedul ing , 
duration, 

specifying,  10-58 
priority, 

specifying,  10-58 
/RPA  keyword, 

SET  command, 

VMR,  10-58 
/RSI  keyword, 

RUN  command, 

VMR,  10-36 
RSX11 . SYS , 

See  Account  file 
RUN  command, 

VMR,  10-36 

command  line  format, 
10-36  to  10-38 
example,  10-39 
keyword , 

/RSI,  10-36 
/UIC,  10-37 
RUNTIME  command, 

IOX,  4-55 


SAB, 

Resource  Accounting,  17-3 
Sanity  timer, 

activating,  15-24 
SAVE  command, 

VMR,  10-40 

command  line  format,  10-40 
example,  10-41 
keyword , 

/BOOT,  10-40 
/DENS,  10-40 
Scan  rate. 

Resource  Accounting,  17-6 
/SEC  keyword, 

INSTALL  command, 

VMR,  10-24 

Secondary  disk  errors,  18-10 
Secondary  pool , 

installing  task  in,  10-24 
Resource  Accounting,  17-5 
use , 

displaying,  10-59 


/SECPOL  keyword. 


SET  command, 

VMR,  10-59 
SELECT  command, 

IOX,  4-56 
$SEP, 

predefined  syntax  element  in 


MML,  12-44 

Serial  command  processing, 
CLI,  11-9 

Serial  Despooler  Task, 

See  Despooler 


SET, 

/PLCTL, 

establishing , 

pool  limits,  13-2, 

13-12  to  13-13 
task  priority,  13-13 
parameter  defaults,  13-13 


SET  ACCOUNTING, 

Resource  Accounting,  17-4 
Set  Accounting  Transaction 
Block,  17-28 
SET  command, 

CON,  15-24 


command  line  format, 
example,  15-25 
option, 

ALARM,  15-24 
CSR ,  15-24 
TIMER,  15-24 
VEC,  15-24 


15-24 


I/O  Queue  Optimization,  16-2 
Shadow  Recording,  18-10 


VMR,  10-43 


command  line  format, 
example,  10-66 
keyword , 

/ABAUD,  10-46 
/AFF,  10-46 
/BOT,  10-47 
/BRO,  10-48 
/BUF,  10-48 
/CRT,  10-48 
/EBC ,  10-48 
/ECHO,  10-49 
/ESCSEQ,  10-49 
/FDX,  10-49 
/FORMFEED,  10-50 
/HFILL ,  10-50 
/HHT,  10-50 
/LIBUIC ,  10-50 
/LINES,  10-51 
/LOGON,  10-51 
/LOWER,  10-51 
/MAIN,  10-51 
/MAXEXT ,  10-53 
/NETUIC ,  10-53 
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SET  command  (Cont.) 

/OPT,  10-53 
/PAR,  10-54 
/PLCTL,  10-55 
/POOL,  10-56 
/POOLSIZE,  10-57 
/PRIV,  10-57 
/PUB,  10-57 
/REMOTE,  10-57 
/RNDC ,  10-58 
/RNDH ,  10-58 
/RNDL ,  10-58 
/RPA ,  10-58 
/SECPOL,  10-59 
/SLAVE,  10-59 
/SPEED,  10-59 
/SUB,  10-60 
/SWPC,  10-61 
/ SWPR ,  10-61 
/SYSUIC ,  10-61 
/TERM,  10-62 
/TOP,  10-63 
/TYPEAHEAD,  10-64 
/UIC,  10-64 
/VFILL,  10-64 
/WCHK,  10-65 
/WRAP,  10-65 
Shadow  Recording, 
catchup,  18-1 
commands,  18-4 
ABORT,  18-7 
CONTINUE,  18-8 
DISPLAY,  18-9 
START,  18-5 
STOP,  18-6 
messages,  B-ll 
preparing  for,  18-2 
restarting  after  errors  on 
disk,  B-ll 
shadowed  pair,  18-1 
UMB  control  block,  18-9 
Shadowed  pair,  18-1 
SHF, 

algorithms,  14-5 
conventions,  14-1 
installation  of,  14-4 
monitoring,  14-5 
overhead,  14-4 
performance,  14-4 
removal  of,  14-5 
shuffling , 

dynamic  common  regions, 
14-6 

partition  sections,  14-7 
static  common  regions, 
14-6 

tasks,  14-7 
size,  14-4 


$SHFCT, 

changing  contents,  14-4 
$SHFTM ,  14-4 

SHOW  ACCOUNTING  commands,  17-3 
SHOW  ACCOUNT ING/- 

TRANSACTION_FILE, 

Resource  Accounting,  17-4 
SHOW  ACCOUNTING/DATATRIEVE , 
Resource  Accounting,  17-4 
SHOW  ACCOUNTING/INFORMATION, 
Resource  Accounting,  17-4 
Shuffler , 

See  SHF 
SHUTUP, 

checkpointing , 

read/write  commons,  8-6 
completion  notification,  8-3 
deallocating , 

checkpoint  space,  8-4,  8-6 
dismounting , 

devices,  8-4,  8-6 
halting , 

processor,  8-4,  8-6 
invoking,  8-1 
logging  off, 

logged-in  terminals,  8-4, 
8-6 

log  ins , 

disabling,  8-2  to  8-3 
enabling,  8-3 
prerequisites ,  8-1 
redirecting , 

console  terminal,  8-4,  8-6 
shutdown , 

RSX-11M  system,  8-4  to  8-6 
RSX-1 1M-PLUS  system, 

8-6  to  8-8 

SHUTUP.CMD,  8-1,  8-3 

submitting  to  Indirect, 

8-3  to  8-4,  8-6 
stopping , 

Console  Logger,  8-4,  8-6 
ERRLOG,  8-4,  8-6 
Queue  Manager,  8-4,  8-6 
Resource  Accounting,  8-6 
task-build  file,  8-3 
terminating,  8-2 
warning  message^  8-2 
SHUTUP.CMD, 
example,  8-4 
installing , 

tasks,  8-1,  8-3 
overview,  8-3 

relationship  to  SHUTUP  task, 
8-3 

submitting  to  Indirect, 

8-3  to  8-4,  8-6 
timeout  interval,  8-3 
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/SIZE  keyword, 

LOAD  command, 

VMR,  10-27 
/SLAVE  keyword, 

SET  command, 

VMR,  10-59 
/SLV  keyword, 

INSTALL  command, 

VMR,  10-24 
Sort  option, 

ACNT ,  2-8 
/SPEED  keyword, 

SET  command, 

VMR,  10-59 
Spooling , 

transparent,  7-1 
SPWN$  directive, 

IOX, 

in  EXECUTE  command,  4-36 
SPY  command, 

IOX,  4-58 
START  command, 

DCL,  7-26  to  7-27 
IOX,  4-59 

Shadow  Recording,  18-5 
START/ ACCOUNTING , 

Resource  Accounting,  17-4 
START/PROCESSOR  command, 

DCL,  7-27  to  7-31 
START/QUEUE  command, 

DCL,  7-26  to  7-27 
START/QUEUE/MANAGER  command, 
DCL,  7-3,  7-26  to  7-27 
Static  common  region, 
checkpointing ,  14-3 
resident  common,  14-2 
resident  libraries,  14-2 
shuffling,  14-6 
Statistics , 
system, 

display  in  RMD,  6-13 
Statistics  scan. 

Resource  Accounting,  17-6 
Status , 
device, 

emitting,  15-12 
displaying , 

during  IOX  exercising, 
4-58 

Status  flag, 
device , 

displaying,  15-9 
list,  15-9 
STOP  command, 

DCL,  7-23 

Shadow  Recording,  18-6 
STOP/ABORT  command, 

DCL,  7-25 


STOP/ACCOUNTING, 

Resource  Accounting,  17-4 
STOP/PROCESSOR  command, 

DCL,  7-24  to  7-25 
STOP/QUEUE  command, 

DCL,  7-23 

STOP/QUEUE/MANAGER  command, 
DCL,  7-23 
/SUB  keyword, 

SET  command, 

VMR,  10-60 
Subpartition , 
creating,  10-60 
eliminating,  10-61 
Summary  report, 

generated  by  PRINTSUMMARY, 
4-47 

IOX,  4-20 

SUMMARYTIME  command, 

IOX,  4-60 
SWITCH  command, 

CON,  15-26 

command  line  format,  15-26 
example,  15-26 
/SWPC  keyword, 

SET  command, 

VMR,  10-61 
/ SWPR  keyword, 

SET  command, 

VMR,  10-61 

$SY, 

predefined  syntax  element  in 
MML,  12-44 
Symbol , 

definition  file,  10-2 
overriding,  10-4 
/SYNC  keyword, 

INSTALL  command, 

VMR,  10-25 
Syntax  element, 

predefined  MML,  12-39  to 
12-40 

Syntax  elements, 

predefined  MML,  12-41  to 
12-45 
SYSGEN, 

DCL,  12-2 
System, 

bootstrapping ,  10-41 
configuration, 
device , 

adding,  15-21 
removing,  15-18 
duplicating,  15-7,  15-17 
information, 

displaying,  10-12,  15-9 
memory  box, 

adding,  15-23 
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System  (Cont.) 

removing,  15-20 
fault,  15-28 

diagnosing,  15-30 
recovering,  15-30 
file  naming, 

convention,  B-4 
file  types,  B-5  to  B-6 
image , 
file, 

configuring,  10-1 
Executive  data  space 
and,  10-2 
foreign, 

writing,  10-4 
saved , 

maximum  size  of,  10-41 
writing,  10-40 

supported  device,  10-40 
multiprocessor , 
diagnostic,  15-32 
stand-alone  maintenance, 
15-32 

multiuser  protection , 
login, 

disabling,  10-51 
enabling,  10-51 
reconfiguration,  15-1 
saving,  10-40 

supported  device,  10-40 
shutdown  task, 

See  SHUTUP 
statistics , 

Resource  Accounting,  17-5 
statistics  display, 

RMD,  6-12 
UIC, 

specifying,  10-61 
System  Account  Block,  17-26 
System  Time  Change  Transaction 
Block,  17-31 

System-controlled  partition, 
14-1 

conventions,  14-2 
definition,  14-2 
fragmentation , 
causes  of,  14-3 
subpartitions  of,  14-2 
waiting  tasks,  14-2 
/SYSUIC  keyword, 

SET  command, 

VMR,  10-61 


TAB, 

Resource  Accounting,  17-3 
Tab, 

hardware  horizontal , 


Tab  (Cont.) 

specifying,  10-50 
Table , 

revector  control  in  RCT, 
status  codes,  5-1 
TAS  command, 

VMR,  10-70 

command  line  format,  10-70 
example,  10-70 
Task , 

aborting , 

using  PMT,  13-7  to  13-9, 
13-11  to  13-12 
active, 
display, 

altering  from  MCR,  6-9 
canceling,  10-11 
CLI, 

installing,  10-22 
removing,  10-35 
common  region, 
fixing,  10-19 
sharing,  10-25 
unfixing,  10-74 
display,  6-8 
dumping,  10-23 
execution  termination,  4-23 
extending,  10-22 
maximum  size, 

specifying,  10-53 
external  header, 
specifying,  10-25 
fixing,  10-18 

restriction,  10-18 
header  display, 

RMD,  6-10 

altering  from  MCR,  6-11 
initiation, 

IOX, 

EXECUTE  command,  4-36 
installed , 
information, 

displaying,  10-70 
installing,  10-20 

checkpointable,  10-21 
secondary  pool,  10-24 
LUNs, 

reassigning,  10-32 
name , 

CLI,  11-4 
naming,  10-25 
nonpr ivileged , 

subject  to  pool  use 

controls,  13-5,  13-13 
nonshuf f leable , 
fixing,  10-19 

overmapping  I/O  page,  10-22 
priority, 

base,  13-5,  13-13 
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Task  (Cont.) 

changing,  10-8 
specifying,  10-23 
removing,  10-34 
reschedul ing ,  10-36 
running,  10-36 
slaved , 

specifying,  10-24 
UIC, 

specifying,  10-25,  10-37 
unfixing,  10-74 
Task  Account  Block,  17-24 
Task  accounting, 

Resource  Accounting,  17-7 
TASK  command, 

RMD,  6-9,  6-11 
/TASK  keyword, 

INSTALL  command, 

VMR,  10-25 

Task-build  command  file, 

RMD, 

modifying,  6-12 
Task-build  file, 

location  of  IOX,  4-22 
TASKLIST  command, 

VMR,  10-70 

TEMPORARYFILE  command, 

IOX,  4-61 
$TERM , 

predefined  syntax  element  in 
MML,  12-44 
/TERM  keyword, 

SET  command, 

VMR,  10-62 
Terminal , 
baud  rate, 

specifying,  10-59 
CRT, 

specifying,  10-48 
dual-port, 

placing  on  line,  15-22 
switching,  15-22 
local , 

specifying,  10-58 
option, 

8-bit  character,  10-48 
autobaud  detection,  10-46 
backwards  deletion,  10-48 
broadcast,  10-48 
echo,  10-49 
escape-sequence 

recognition,  10-49 
fill  characters,  10-50 
vertical,  10-64 
full-duplex ,  10-49 
hardware , 

form  feed,  10-50 
horizontal  tab,  10-50 
read-pass-all ,  10-58 


Terminal  (Cont.) 

typeahead,  10-64 
wrap-around ,  10-65 
privilege, 

specifying,  10-57 
remote , 

baud  rate, 

specifying,  10-57 
specifying,  10-57 
slaved , 

running  RMD  on,  6-2 
specifying,  10-59 
type, 

hal f-duplex ,  10-62 
specifying,  10-62 
standard,  10-62 
UIC, 

specifying,  10-64 
Test  configuration, 

IOX, 

pattern  altering,  4-46 
pattern  displaying,  4-46 
setup,  4-6 

$TI , 

predefined  syntax  element  in 
MML,  12-45 

Time, 

displaying,  10-72 
of  IOX  exercise,  4-55 
setting,  10-72 
$TIME, 

predefined  syntax  element  in 
MML,  12-42 
TIME  command, 

VMR,  10-72 

command  line  format,  10-72 
example,  10-72 
TIMER  option, 

SET  command, 

CON,  15-24 
/TOP  keyword, 

SET  command, 

VMR,  10-63 
Transaction  file, 

account  block  linkages,  17-40 
account  blocks,  17-3,  17-21 
system  account  block 
(SAB) ,  17-3 

task  account  block  (TAB) , 
17-3 

transaction  account 
blocks,  17-3 

user  account  block  (UAB) , 
17-3 

accumulation  fields,  17-35 
block  diagrams,  17-24 
card  reader  job  data,  17-3 
card  reader  spooling  block, 
17-38 
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Transaction  file  (Cont.) 

crash  recovery  block,  17-37 
device  allocation, 
deallocation,  or 
dismount  data,  17-2 
device  mount  data,  17-2 
device  statistics  block, 
17-39 

device  usage  data,  17-3 
disk  accounting  block,  17-37 
example,  17-13 
header  area,  17-34 
in  DATATRIEVE-1 1 ,  17-17 
invalid  login  block,  17-37 
logon  data ,  17-2 
offset  definitions,  17-34 
print  despooler  block,  17-38 
print  job  data,  17-2 
set  accounting  block,  17-37 
size,  17-5 

system  account  block,  17-36 
system  data,  17-2 
system  time  change,  17-3 
system  time  change  block, 
17-38 

task  data,  17-1 
user  account  block,  17-35 
user  data,  17-1 
Translator  table, 

DCL,  12-6  to  12-12,  12-17  to 
12-20,  12-46  to  12-47 
Transparent  spooling,  7-1 
$TST, 

predefined  syntax  element  in 
MML,  12-45 
TST  macro, 

MML,  12-39 
$TSTN0T, 

predefined  syntax  element  in 
MML,  12-45 
/TYPEAHEAD  keyword, 

SET  command, 

VMR,  10-64 

Typeahead  option,  10-64 


UAB , 

Resource  Accounting,  17-3 
UETP, 

console  dialog  example,  9-7 
environment  needed  to  run, 
9-3 

error  message,  9-5 
LOGGER. TSK,  9-5 
system  configuration 
module,  9-5 
error  messages. 


UETP  (Cont.) 

NUL1.TSK,  9-6 
QTRUN.TSK,  9-6 
error  reporting,  9-4 
load  test, 
purpose,  9-2 

requirements  for  RSX-11M, 
9-2 

modules,  9-1 

operating  procedures,  9-4 
requirements  in 

RSX-1 1M-PLUS ,  9-3 
requirements  in  RSX-11M,  9-3 
running,  9-4 
IOX,  9-2 
utilities,  9-2 
structure,  9-1 
testing , 

interactive  utilities,  9-3 
MCR  commands,  9-3 

UFD, 

definition,  B-l 
system, 

example,  B-3  to  B-4 

UIC, 

authorized,  2-1 
contained  in  account  entry, 
2-1,  2-5,  2-7 
DECnet,  10-53 
default,  10-64 
displaying,  2-4 
distinction  by  password,  2-1 
library,  10-50 
system,  10-61 
task,  10-25 
terminal,  10-64 
$UIC, 

predefined  syntax  element  in 
MML,  12-42 
/UIC  keyword, 

INSTALL  command, 

VMR,  10-25 
RUN  command, 

VMR,  10-37 
SET  command, 

VMR,  10-64 
$UICE , 

predefined  syntax  element  in 
MML,  12-42 
UMB  control  block. 

Shadow  Recording,  18-9 
UNF  command, 

VMR,  10-74 
UNFIX  command, 

VMR,  10-74 

command  line  format,  10-74 
example,  10-74 
keyword , 

/REG,  10-74 
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UNFIX  command  (Cont.) 

/RON ,  10-74 
UNITS  keyword , 

CON  command, 

VMR,  10-12 
DISPLAY  command, 

CON,  15-9 
UNL  command, 

VMR,  10-75 
UNLINK  command, 

CON,  15-27 

command  line  format,  15-27 
example,  15-27 
UNLOAD  command, 

VMR,  10-75/ 

command  line  format,  10-75 
example,  10-75 
User  Account  Block,  17-25 
User  Environment  Test  Package, 
See  UETP 

Usjer  File  Directory,  B-l 
See  UFD 

User  Identification  Code, 

See  UIC 

User-controlled  partition, 

14-1 

Utilities, 
interactive , 

testing  in  UETP,  9-3 
RSX-11M, 

relationship  to  RCT ,  5-4 
UETP,  9-2 


VEC  keyword , 

CON  command, 

VMR,  10-15 
VEC  option, 

SET  command, 

CON,  15-24 
Vector  address, 
changing,  10-12 
VERIFY  command, 

IOX,  4-62 

effect  on  NFS  volume,  4-7 
Vertical  fill  characters 
option,  10-64 
/VFILL  keyword, 

SET  command, 

VMR,  10-64 

Virtual  Monitor  Console 
Routine , 

See  VMR 
VMR,  10-1 
command , 
line,  10-4 

comment  in,  10-5 
name,  10-4 


VMR  (Cont.) 

parameter,  10-4 
summary,  10-5 
error  message,  10-76 
file  specification,  10-3 
/IM  switch,  10-4 
indirect  command  file,  10-3 
keyword,  10-4 

relationship  with  MCR,  10-1 
starting,  10-1 
terminating,  10-3 
Volume , 

Files-11, 

protecting  with 

TEMPORARYFILE,  4-61 

NFS, 

block  range  altering,  4-50 
block  range  display,  4-50 
list  of  parameter  commands 
for,  4-8 

retries  upon  error,  4-54 
selecting , 

with  IOX,  4-56 
with  VERIFY,  4-62 
selecting , 

Files-11  for  IOX,  4-7 
NFS  for  IOX,  4-7 
VOLUMECHECK  command, 

IOX,  4-63 


WAIT  command, 

IOX,  4-64 
$WALFN, 

predefined  syntax 
MML ,  12-40 
/WCHK  keyword, 

SET  command, 

VMR,  10-65 
$WDONUM , 

predefined  syntax 
MML,  12-40 

$WFIL, 

predefined  syntax 
MML,  12-41 
$WFILE, 

predefined  syntax 
MML,  12-41 
Wi  ldcard , 

DISPLAY  command, 
CON,  15-10 
$WONUM , 

predefined  syntax 
MML,  12-40 
/WRAP  keyword, 

SET  command, 

VMR,  10-65 
Wrap-around  option. 


element  in 


element  in 

element  in 

element  in 


element  in 


10-65 
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Write  checking, 
specifying,  10-65 
Write  lock, 

write-back  cache  data, 
handling  in  RCT,  5-4 
Write-check, 

enabling  in  IOX,  4-65 
WRITECHECK  command, 

IOX,  4-65 


$WUIC, 

predefined  syntax  element  in 
MML,  12-42 


/XHR  keyword, 

INSTALL  command, 
VMR,  10-25 
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